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PREFACE 


PILOT is a simple, easy-to-understand programming language. It Stands for Programmed 
Inquiry, Learning Or Teaching, and was originally developed by Dr. John Starkweather at 
the University of California, San Francisco. PILOT was designed to enable teachers to 
write programs for their students. However, due to the pioneering work of Dr. Dean 
Brown at Stanford Research Institute’s Education Laboratory (1967-1974), PILOT proved 
to be a good language for teaching Computer programming to children. PILOT was con- 
ceived as a tool to make writing conversational programs easy. It was originally designed 
for text output only. However, we have incorporated Turtle Graphics, a concept 
developed by Dr. Seymour Papert and the LOGO group at the Massachusetts Institute of 
Technology. The Turtle Graphics concept enables the user to draw pictures when pro¬ 
gramming in PILOT. These capabilities, along with the ability to generate sounds, make 
ATARI® PILOT a very versatile language. 
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INTRODUCTION 






This reference guide is designed for your use if you are learning PILOT at home or in 
school, or if you already know PILOT and need a handy guide to the language. It gives 
brief explanations of all the main PILOT commands and examples of their use. 
Throughout this guide there are illustrations to enhance your understanding and enjoy- 
ment of PILOT. You are the pilot character; you give PILOT commands to the Computer. 
Anytime you are in Graphics mode, the turtle character is ready to obey your commandb. 
Each PILOT command is highlighted in large bold letters at the top of a page so you can 
easily find any command to which you wish to refer. This reference guide is divided inte 
the foüowing sections: PILOT Information, Core PILOT, Executive Commands, 

Graphics, Sound and Pause, and Conditionals. 

In the first section, you will find terms to know and general Information about the PILOT 
.anguage. You should be familiär with the contents of this section in Order to use this 

guide. 


The second section reviews the Core PILOT commands. You put these commands 
together as a set of numbered Statements to form a program. You can also execute them 
one at a time in Immediate mode, just as you would use a pocket calculator. 

The third section reviews Executive commands. These commands allow you to do various 
things with programs as a whole. You give executive commands directly from the 
keyboard; usually they are not part of a program. 

The fourth section covers turtle Graphics commands, which you use to draw designs or 
pictures on the screen. When PILOT is in graphics mode, an in visible turtle, holding an 
mvisible pen, moves around the screen following your commands, drawing lines and fill- 
ing in spaces. 

The fifth section has to do with the SOUND and PAUSE commands. SOUND is most fre- 
quently used when you want to make music, but can also help you create sound for a 
special effect. PAUSE lets you create a dramatic effect in a program, but it is used most 
often when creating music; for example, when you need to indicate how long a tone is to 
be played. 

The last section discusses Conditional commands. Any PILOT command can be made 
conditional; that is, it will only be carried out if certain conditions are met. This section 
reviews the various kinds of conditions you can set up in your programs. 

This is just a reference guide. If you need further explanation of any PILOT command, or 
if you wish to learn PILOT from a book, you should refer to the PILOT Primer: An In- 
structional Manual for the PILOT Programming Language. 
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1 PILOT INFORMATION 












This section contains general Information about PILOT. It includes explanations of terms 
often used in this guide, PILOT operating modes, variables, arithmetic and relational 
operators, and error messages. 


TERMS 

COMMANDS 


CONSTANT 

CURSOR 

EXPRESSION 

INPUT 

LABEL 

MEMORY 


Commands teil the Computer what to do. There are two kinds of 
commands: Program Commands and Executive Commands. 

Program Commands are the building blocks of the PILOT 
language. They are composed of one or two letters followed by a 
colon (:). When placed in a logical sequence, these commands 
make up a program. 

Executive Commands teil the Computer what to do with a program 
as a whole. Executive commands are either a short word such as 
RUN or an abbreviation such as DOS. 

A constant is a value expressed as a number rather than 
represented by a variable name. For example, in the Statement: 

C:#X= 100 

#X is a variable, and 100 is a constant. 

The white square that moves across the television screen showing 
your location on the screen as you type. 

An expression is any combination of variables, constants, and 
arithmetic or relational operators used together to compute a 
value. For example, #A + #B\ 2 is an expression; so is 

#A<=#B. 

Any information put into the Computer from the keyboard, cassette 
tape, disk, and so on. 

Code name or symbols given to a Statement in a program to iden- 
tify that Statement for reference by a J: or U: command. PILOT 
labels may be any combination up to 254 characters. Labels must 
Start with an asterisk ( % ) and a letter; for example, ❖ HERE or 
* M35PDQ. 

The part of the Computer where information is stored. This infor¬ 
mation is both program Statements and data (constants and 
variables) that the program uses when it is run. 


2 Pilot Information 






OUTPUT Information put out from the Computer memory to external 

devices. 

PILOT PILOT Stands for Programmed Inquiry, Learning Or Teaching. 

PROGRAM A set of Statements in a logical sequence that teils the Computer 

what to do. The Computer follows the program Statements in 
Order, from beginning to end, unless a J: JUMP or U: USE com- 
mand breaks the sequence. 

SCREEN DISPLAY What you see on the television screen. 

STATEMENT A Statement is one line of a program. All PILOT Statements begin 

with line numbers (used for editing and sequencing) . A PILOT 
Statement may be labeled with a sjs LABEL between the line 
number and the command. 

STRING A group of characters—letters, numbers, punctuation, or ATARI 

Graphics (CTRL) characters. The following are all 
strings: 

ABCXYZZZ 

“Quotes Too” 

02BAK9 

/\/\/\/\/\/\/ 

5 + 2 = 

Note that quotation marks are not used to identify a string. Any 
group of characters, including quotation marks, is a 
string in PILOT. 

A string is like a constant, in that it may be stored in a 
string variable. 

VARIABLE A variable is the name of a place in memory to störe a string or 

numeric value that is used by a program. This value may (or may 
not) change as the program is executed. (See the following page 
for an explanation of the different types of PILOT variables.) 


OPERATING MODES 


PILOT has two kinds of modes: Programming Modes which determine how PILOT com- 
mands are used by the Computer; and Screen Modes which determine the layout of the 
display screen. 
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AUTO 

IMMEDIATE 

RUN 


Programming Modes 

The mode in which the Statements will automatically be numbered 
when writing a program. 

The Immediate mode is used when you want your commands to 
respond right away after pressing the key. 

In Run mode, PILOT is executing (carrying out) the program cur- 
rently stored in memory. 


Screen Modes 

GRAPHICS The Graphics mode is used when you want to draw a picture of 

any kind. 

TEXT The Text mode displays only text (letters, numbers, punctuation) 

and graphics (CTRL) characters. 


VARIABLES 


PILOT has two main kinds of variables: string variables and numeric variables. 

String Variables can störe strings of up to 254 characters. They are named with a $ Sym¬ 
bol, followed by any combination of letters and numbers. For example, $NAME, 
$M29ABD, $FOOD9 are acceptable string variable names. String variables cannot be 
used in arithmetic expressions. A program can contain any number of string variables up 
to the limits of memory. 

Numeric Variables can störe numbers from -32768 through 32767. They are named 
with a # symbol, followed by a single letter; #A, #B, #C, and so on up to #Z are the 
acceptable numeric variable names. A program can have up to 26 numeric variables. 

They can be used in arithmetic and relational expressions. 

Note: PILOT has two other kinds of variables that are not discussed in this guide. Pointer 
variables, named with an @ symbol followed by a decimal memory location, are used to 
examine or change the contents of a specific memory location (equivalent to PEEK and 
POKE in the BASIC language). Special variables, named with a % symbol followed by a 
letter or a letter and a number, are used to sense the values of the various ATARI Con¬ 
trollers (joysticks, paddles, and light pen) and to read other special values maintained by 
the PILOT System. 

The use of Controllers and special graphics variables is explained in The PILOT Primer, 

An Instruction Manual for the PILOT PROGRAMMING LANGUAGE. 
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Information on the use of pointer variables and other special variables may be obtained by 
phoning ATARI, INC., Customer Support: 

(800) 538-8547 (Outside California) 

(800) 672-1430 (Within California) 


ARITHMETIC OPERATORS 

The ATARI PILOT language uses five arithmetic operators: 

+ addition 

- subtraction (also denotes a negative numbers; e.g., -5) 

*5f multiplication 
/ division 

\ modulo (the remainder after a division) 

Note: PILOT only performs integer (whole numbers) arithmetic. 


Parentheses ( ) can be used to change the order in which arthmetic is performed. For ex- 
ample C:#A = 5 + 6 Jfc 2 puts the number 22 in variable #A; on the other hand, 

C:#A = 5 + (6 Jfc 2) puts the number 17 in variable #A. 


RELATIONAL OPERATORS 


PILOT allows the result of the comparison between two variables or constants to be used 
as a condition for executing a command. The comparison is made with the use of the 
following relational operators: 


#A < #B 
#A > m 

#a = m 

#A < = #B 
#A > = #B 
#A < >#B 


#A is less than #B 
#A is greater than #B 
#A equals #B 

#A is less than or equal to #B 
#A is greater than or equal to #B 
#A is not equal to #B 


(See Section 6, Conditionals.) 
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ERROR MESSAGES 


If you make an error, PILOT responds by showing the command or Statement in error. It 
highlights the source of the error or the first character it does not understand. It also types 
out a message explaining the error. 

The are two kinds of errors: Syntax errors result from incorrectly typing in a command. 
Syntax errors are found by PILOT as you are typing commands or program Statements in- 
to the Computer. 

The second type of error is a Run-time error which results from mistakes in the logic of 
your program - for example, trying to jump to a Statement that you have not labeled. 
Run-time errors are only found when you type RUN and PILOT tries to execute your 
program. 


The following are some common PILOT error messages: 


WHAT’S THAT? 

I/O ERROR xxx 

NO ROOM 

WHERE? 

U: TOO DEEP 
DIVIDE BY 0 


Indicates that PILOT could not understand your command or what 
you wanted it to do. This message is often the result of typing or 
spelling errors. 

In the course of performing an I/O Operation the I/O Subsystem 
detected an error and returned the Status indicated. See Appendix 
B for a list of I/O error codes. 

Indicates that the requested Operation could not be performed 
because there was not enough free memory. 

Indicates that the sfc LABEL named in a U: (USE) or J: (JUMP) 
command does not exist in the program storage area. 

The program has exceeded eight levels of nested USE commands. 

A COMPUTE command has just attempted to perform a division 
by zero. 
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T: 

Type 


The T: (TYPE) command teils the Computer to display what you type. You must type T: 
first, then your message. For instance, T:HELLO will cause the Computer to respond 
HELLO as you see in Figure 2-1. 


Figure 2-1 

The T: command will display anything you can type from the keyboard literall y. That is, 
the T: command will not add 2 + 2; it will display it as 2 + 2 (see Figure 2-2). 
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Figures 2-3 and 2-4 are examples of programs using the T: command. Notice that Figure 


2-4 uses graphics characters that are created by holding down the 
the letters. 


key while typing 


10 T : THI5 IS 

29 T : A UERY SHORT 

30 T:PROGRAM 



Figure 2-3 


10 T : THIS PROGRAM MAKES A DESIGN 
20 T•USING GRAPHICS CCTRL) 
CHARACTERS 
30 T: 

40 T : 

50 T: 




THIS PROGRAM MAKES A DESIGN 
USING GRAPHICS CCTRL) CHARACTERS 



Figure 2-4 


The backslash (\ ) has a special meaning to the T: command. Rather than printing the 
next output on a separate line, the backslash teils the Computer to continue on the same 
line (see Figures 2-5 and 2-6). 
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Note: The Computer will automatically move to the next line when it runs out of room. 


10 T : THI5 WILL X 
28 T:ALL PRINT X 
30 T : ON ONE LINE. 

RUN 



Figure 2-5 


10 T:DO YOU READ ME? V 
20 A: 

30 T:GOOD 


DO YOU READ ME? YES 
GOOD 

READY 


Figure 2-6 


When a T: command sees a string ($) or numeric (#) variable, it automatically replaces 
those variable names with their contents if they have been given a value (see Figure 2-7). 
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10 T :HHAT ' S YOUR NAME? 

20 A:$NAME 

30 T : HOM OLD ARE VOU? \ 

40 A:»A 

50 T:$NAME IS ttA YEARS OLD. 


READY 



MHAT * S YOUR NAME? BOBBY 
HOW OLD ARE YOll? 13 
BOBBY 15 13 YEAR5 OLD. 

READY 


Figure 2-7 



m 

m 
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A: 

Accept 



The A: (ACCEPT) command teils the program to wait for information to be typed from 
the keyboard. Figure 2-8 is an example of a simple use of the A: command. 


le T i MHAT COLOR ARE YOUR SHOES? 
26 A : 

30 T : I DON ' T WEAR SHOES . 

40 T : COMPUTERS DON 1 T HAUE FEET . 

READY 



Figure 2-8 


The A: command also lets you give a value to a string ($) or numeric (#) variable as 
shown in Figures 2-9 and 2-10. 


10 R:COPY CAT PROGRAM 

HI- I • M A COPY CAT. 

20 T:HI, I'MACOPY CAT 

TYPE SOMETHING/ AND I WILL SHOW YOU . 

30 T!TYPE SOMETHING^ AND I WILL 

HELLO 

SHOW YOU . 

HELLO 

40 *AGAIN 

YOU'RE A COPY CAT 

50 A:SCOPY 

YOU'RE A COPY CAT 

60 T:$CQPY 

SO ARE YOU 

70 J:«AGAIN 

SO ARE YOU 


THIS IS SILLY 

READY 

THIS IS SILLY 

■ 

STOP 


STOP 


HOW DO I GET OUT OF THIS 


HOW DO I GET OUT OF THIS 


■ 

' - ' 


Figure 2-9 
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10 R:AGE OLD PROGRAM 

HOH OLD ARE YOU? 

4 r* 

20 TiHOW OLD ARE VOU? 

8 

^81 

30 A:»V 

JUST THINK f IN 92 YEARS . 


40 C:»L=100-ttV 

VOU ■ LL BE 100. 

^ v < * % 1 

50 T:JUST THINK, IN «L VEAR5, 

i ' . V: 


60 T:VOU'LL BE 100. 

READV 

■ 


READV 



■ 




! 

* | 



Figure 2-10 
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Match 



The M: command matches the answer entered by a user (during an A: command) with 
one or more answers expected by the program. Also, M: automatically creates a YES or 
NO condition —Yes (Y) there was a match, or NO (N) there was no match. Figure 2-11 
shows how this works. 


16 R:HEATHER TO DO 

20 TIHOH'S THE MEATHER OUTSIDE? 

30 A: 

40 M:NICE,GOOD,HOT..GREAT 
50 TY : GOTO THE PARK AND PLAY . 

60 TN : 5TAY HOME AND READ A BOOK . 
70 E : 

READY 
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Figure 2-11 


In Figure 2-11, if the answer matches nice, good, hot, or great, the program types “Go to 
the park and play” (line 50). If the answer does not match, the program types “Stay 
home and read a book” (line 60). 


In the list of match choices, if you put a space followed by a single letter, the Computer 
will match anything starting with that letter. For example, in Figure 2-12 below, the 


M:(space)Y will match any word that starts with the letter Y; this would include YES, 
YUP, YEAH, YOU BET, or even YUK! 



10 R:WÖVE5 
20 »WATER 



68 T : MORE WAUES? V 
70 A : 

80 M: Y..OK..0 . K . .. ALRIGHT..SURE 
90 JY: »WATER 
100 E: 

READY 


Figure 2-12 


Note: The JY: command in line 80 of Figure 2-12 is a conditional JUMP command. See 
J: (JUMP) or Section 6, Conditionals, for an explanation. 
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The Computer will look to see if any of the choices in a match list are contained, exactly, 
in any part of an answer. The program in Figure 2-13 below will match on SAL or SAM 
as any part of the answer. This means that all of the following will create a match: SAL¬ 
LY, SALT, SALAD, SALUTE, SALAMI, SAMMY, SAMUEL, and SAME. 


10 R:SAM 1 S & SALLY 1 S PROGRAM 
20 T:HI, HHÖT'5 YOUR HftME? 

30 «AGAIN A : SNAME 
40 M:SAM,SAL 

50 TN : X ONLY TALK TO PEOPLE HAMED 
60 TN:5AM OR SALLY . . . 

70 TN : PLEA5E TELL ME YOUR NAME 
AGAIN: 

80 JN:«AGAIN 

90 TY : NICE TO HEET YOU, SNAME . 
100 E: 

READY 



HI, WHAT 1 S YOUR NAME? 

? ; GERTRUDE 

I ONLY TALK TO PEOPLE NAMED 
SAM OR SALLY . . . 

PLEASE TELL ME YOUR NAME AGAIN: 
SALAD DRESSING 

NICE TO MEET YOU, SALAD DRESSING. 
READY 


' 



Figure 2-13 
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J: 

Jump 



The J: (JUMP) command lets you jump from one spot in a program to another. The J: is 
ALWAYS followed by a % LABEL indicating to which Statement you want to jump. The 
destination of your J: command must also be labeled with the same LABEL. 

Figure 2-14 shows how the J: command can be used to make a simple loop. The pro¬ 
gram keeps looping (repeating), filling the screen with ROUND ROBIN. 


18 R:LOOPING PROGRAM 
28 »OMER 

38 T:ROUND ROBIN \ 

40 J : »O0ER 

READY 



ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
| ROUND ROBIN ROUND ROBIN ROUND ROBIN 

ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 
ROUND ROBIN ROUND ROBIN ROUND ROBIN 


38 T : ROUND ROBIN \ 
***** RFADY *** 



Figure 2-14 
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Note: Figure 2-14 is an example of a never-ending loop. To stop it, press the 
key. 


BRBA 


H* LABELS can stand alone as in line 20 of Figure 2-14, or they can be placed in front 
of another command, as in lines 70 and 130 in Figure 2-15. This screen also shows you 
how the J: command is used conditionally following an M: command. That is, JY: 
(JUMP only if there is a match), or JN: (JUMP if there is no match). 


10 R!RIDDLEPROGRAM 

28 T: DO YOU LIKE RIDDLES? \ 

30 öS 

40 M:YES^YUP^VEAH^SURE.-OK^ 

0.K.ALRIGHT 
50 JN:*BYE 

60 T i OK, HERE 1 S A RIDDLE FOR YOU ! 
70 *AGAIN TiHHAT'S BLACK AND 
WHITE AND RED ALL ODER? 

80 A: 

90 M:SUNBURNEDPENGUIN 
100 TNSNOPE^ GUES5 AGAIN 
110 JN:*AGAIN 
120 T : TERRIFIC ; YOU GOT IT ! 

130 *BYE T : SEE YOU AROUND . 

140 E : 

READY 


DO YOU LIKE RIDDLE5? SURE 
OK f HERE 1 S A RIDDLE FOR YOU : 

HHAT ' S BLACK AND WHITE AND RED ALL 
OUER? 

A NEWSPAPER WITH KETCHUP ALL OUER 
HOPE, GUESS AGAIN: 

WHAT ’ S BLACK AND WHITE AND RED ALL 
OUER? 

A BLUSHING ZEBRA 
NOPE, GUESS AGAIN: 

WHAT 1 S BLACK AND WHITE AND RED ALL 
OUER? 

A SUNBURNED PENGUIN 
TERRIFIC; YOU GOT IT! 

SEE YOU AROUND. 

READY 


Figure 2-15 
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C: 

Compute 



Any time you want to do arithmetic in PILOT, you must use the C: (COMPUTE) com- 
mand with numeric variables. As an example, the program in Figure 2-16 lets you input 
two numbers, and then it computes their average (#A). 


10 R:AVERAGEPRQGRAM 
20 *DOAGAIN 

30 T:THIS PROGRAM COMPUTES THE 
AVERAGE 

40 TiOF THO NUMBERS 
50 T: 

60 T : FXR5T NUMBER? S. 

70 A:nF 

80 T : 5EC0ND NUMBER? \ 

90 A:«5 

100 C:»A=«F+»S/2 
110 T: 

120 T : THE AVERAGE OF «F AND »5 15 
«A . 

130 T: 

140 J:*DOAGAIN 
READY 


THXS PROGRAM COMPUTES THE AVERAGE 
OF TWO NUMBERS. 

FIRST NUMBER? 10 
SECOND NUMBER? 20 

THE AVERAGE OF 10 AND 20 IS 15 . 

THIS PROGRAM COMPUTES THE AVERAGE 
OF TWO NUMBERS. 

1 FIRST NUMBER? 2 

SECOND NUMBER? 5 

THE AVERAGE OF 2 AND 5 IS 3 . 

■ 


Figure 2-16 


Note: PILOT will evaluate arithmetic expresions from left to right unless you have 
used parentheses to show a different grouping. 
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BN 
















The C: command is often used to count things in a program. For example, you might 
want to give a person three chances at answering a riddle. A numeric variable such as 
#G is used to keep track of the number of guesses made so far. A numeric condition is 
used to find out whether or not #G has reached the limit (three in this case). Figure 2-17 
below shows you how this looks in a program. 


16 R : THREE GUESSES 
20 C:ttG = l 

30 T:HERE 1 SA RIDDLE. 

40 T : VOU GET 3 GUESSES : 

50 «AGAIN T : HHAT KIND OF PERSON 
LOVES COCOA? 

60 A: 

70 M: COCONUT f COCOANUT , COCOA 
NUT f 

80 TV : VERY GOOB.: VOU 1 RE SMART ! 

90 JY:*BYE 

180 JCttG=3): »NOMORE 

110 TiNOPE^ GUESS AGAIN 

120 C:**G=ttG + l 

130 J:*AGAIN 

140 «NOMORE T:SORRY^ THAT■S 3 
GUESSES. 

150 T : THE ANSMER IS . . . . 

160 PA:90 

170 T: 1 ■ A COCOA NUT. 1 * 

180 »BYE T : BYE BVE 
190 E : 

READY 



HERE'S A RIDDLE. 

YOU GET 3 GUESSES: 

MHAT KIND OF PERSON LOVES COCOA? 

A COCOA LOVER 

NOPEGUESS AGAIN . . . 

HHAT KIND OF PERSON LOVES COCOA? 

A COCOA LOCO 

NOPE j, GUESS AGAIN . . . 

HHAT KIND OF PERSON LOVES COCOA? 

A COCOA MONSTER 

SORRY. THAT'S 3 GUESSES. 

THE ANSHER IS ... A COCOA NUT. • ' 
BYE BYE. 


READY 


Figure 2-17 


Note: The numeric conditional in the J: command in line 100 is explained in Section 6. 

You may also use the C: (COMPUTE) command to give a value to a string ($) variable 
within a program. For example, the program in Figure 2-18 keeps adding one more star 
( sjc ) to the value of the string variable $GROW until the value reaches 21 stars. 


10 R : GROHING STARS 
20 C:$GROH= 

30 C:SSTAR=* 

40 C:»C=0 

50 «LOOP 

60 C:«C=«C+1 

70 C .’ 5GROH=$GROH$STAR 

80 T:5GROH 

90 JCttC<21):«LOOP 

100 E : 

READY 


4 V'vW 4/ -Xi 


* 

** 

*** 

***** 

***** 

****** 

******* 

******** 

********* 

********** 

*********** 

************ 

************* 

************** 

*************** 

**************** 

*****************' 


Figure 2-18 
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RANDOM NUMBERS 


f 


m 



Besides the examples above, the C: (COMPUTE) command will let the Computer select 
numbers at random. For example, if all the numbers allowed by PILOT were mixed up in 
a large fish bowl, the Computer would reach into the bowl and choose one by chance. 
The random number is expressed as a ? for the value of a numeric variable in a C: com¬ 
mand. For example, 

C:#R = ?. 


The program in Figure 2-19 generates random numbers and types them out. 


10 R:RANDOM NUMBERS 

-7246 

20 MfiGAIN 

-7745 

30 C:«R=? 

-16999 

40 T:«R 

31260 

50 J:*AGAIN 

-28265 


31203 

READY 

-19340 

■ 

786 


15452 


38291 


-11243 


20631 


-15334 


-22315 


■ 


\ . .. . . . . ■ ' 'r;: 




Figure 2-19 
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You can teil the Computer only to select random numbers from 0 through an upper limit. 
Simply place a backslash (\ ) and the upper limit after the question mark (?). For exam- 
ple, C:#R = ? \ 10 will choose a random number from 0 through 9. The COIN TOSS 
program in Figure 2-20 randomly generates only 0’s (HEADS) and l’s (TAILS). 



10 r:COIN FLIP 
20 »MORE 
30 C:BR=?\2 
40 TCttR=0):HEADS 
50 TCBR=1) : TAILS 
50 J:»MORE 

READY 



HEADS 

HEADS 

TAILS 

TAILS 

TAILS 

TAILS 

HEADS 

TAILS 

HEADS 

HEADS 

TAILS 

TAILS 

TAILS 

HEADS 

HEADS 

HEADS 

HEADS 


II 


1 I 


A numeric variable can be used as the upper limit for selecting a random number. For 
example, the program in Figure 2-21 allows you to type in the maximum amount that a 
drunkard will turn at each step as he staggers for 200 paces. 



10 *DRUNKMALKER 
20 GR:CLEAR 

30 T:ENTER MAXIMUM TURNC0-3501: X 
40 A:HR 

50 T : 5“ CCLEAR SCREEN] 

50 TIDRUNKENHALKER MAX . TURN = 

HR D EG . 

70 C:HC=0 

80 *HALK 

SO GR:DRAM 5 

100 PA:5 

110 GR : TURN ?\HR 

120 C:HC=BC+1 

130 J(BC<200J:«HALK 

140 E: 

READY 



Figure 2-21 
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The GUESS MY NUMBER program in Figure 2-22 gives you a more complete example 
of how you can use the random number feature of PILOT. 


GUESS MY NUMBER 
1 1 M THINKING OF A NUMBER 
FROM 1 — 100 


1 HILL TE LL YOU IF YO UR GUESS 
OR f 


TOO LOHLLITDO HIGH 


10 R 
20 T 
30 T 
40 T: 

50 TiTRY TOGUESSHHAT IT IS 
60 T : 

70 T 
80 T 
90 T : 

100 T : ARE YOU READY TO PLAY? 

110 A : 

120 M: Y,SURE,OK,ALRIGHT 
130 JN:«BYE 
148 *BEGIN 

150 T:* ECLEAR THE SCREEN 1 
160 C:BR=?\100+1 
170 C:«C=0 

180 T:OK, I HAUE A NUMBER IN MIND. 
ISO T : 

2O0 *AGAIN 
210 T: 

220 T:YOUR GUESS? X 
230 A:»G 

240 C:»C=HC+1_ 

250 TCBG<ttRl i lliliMgiin ; GUESS 

AGAIN . . . _ 

260 Tt«G>«R) i FI'iHiraHTl . GUESS 
AGAIN . . 

270 JCttGOttR) :*AGAIN 

280 T: YOU GOT IT. . . IN ONLY ttC 

GUESSES! 

290 U.'MBEEP 
T : 

T : DO YOU MANT TO PLAY AGAIN? V 
A: 

M:Y,SURE,OK,ALRIGHT 
JY:*BEGIN 

*BYE T : OK, SEE YOU AROUND . 

E : 

»BEEP 
C:ON=8 
C:»S=10-»C 
*BEEPAGAIN 
S0:13 
PA: 8 
SO: 0 

c:«N=«N+1 

J(»N<»5J :*BEEPAGAIN 


300 

310 

320 

330 

340 

350 

360 

370 

380 

390 

400 

410 

420 

430 

440 

450 

460 

470 

480 

490 


SO:13,17,20,25 
PA : 60 
SO : 8 
E: 


I' M THINKING OF A NUMBER 
FROM 1-1O0. 

TRY TO GUESS WHAT IT IS. 

I KILL TE LL YOU IF YOU R GUESS IS 

033 HHS or Unii liKHil . 

ARE YOU READY TO PLAY? YESB 


OK, I HAUE A NUMBER IN MIND. 

YOUR GUES S? 50 

EEEI DECO; GUESS AGAIN . . . 

YOUR GUES S? 85 

ililflnPTfl : GUESS AGAIN . . . 

YOUR GUES S? 95 

lüBi nirnn: guess again . . . 

YOUR GUES S? 98 
ililil lWim : GUESS AGAIN . . . 

YOUR GUESS? 99 

YOU GOT IT ... IN ONLY 5 GUESSES! 
DO YOU HANT TO PLAY AGAIN? ■ 


READY 


Figure 2-22 
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E: 

End 



The E: command marks the END of something. In Figure 2-23 below, it marks the END 
of your program. 


10 R:SUDDENENDING 
20 T : ONCE UPON A TIME 
30 T:THERE MAS A COMPUTER 
40 T : HAMED HAL . 

50 T : HAL STARTIMG ACTING STRANGE 
60 T : SO AN ASTRONAUT NAMED DAVE 
70 T:PULLED OUT HAL ■ S . . . 

80 E : 

READY 


ONCE UPON A TIME 
THERE MAS A COMPUTER 
NAMED HAL . 

HAL STARTED ACTING STRANGE. 
SO AN ASTRONAUT NAMED DAUE 
PULLED OUT HAL'S. 

READY 


Figure 2-23 
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The end of a program is not necessarily the last line of the program. In Figure 2-24, the 
E: command is used to mark the END of the program at line 70, and it is also used to 
mark the END of the TRUMPETS module at line 120. 


10 R:FANFARE PROGRAM 

20 T:WELCOME TO PILOT 

30 U:«TRUMPETS 

40 PA:10 

50 U:»TRUMPETS 

60 T:THE END 

70 E: 

80 »TRUMPETS 
90 S0:l,5..9^13 
100 PA:120 
110 SO : O..0..0..0 
120 E: 

READY 


j m 


WELCOME TO PILOT 
THE END 


READY 

■ 




««SB 


HW 


■ 


Figure 2-24 
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U: 

Use 



The U: command teils the Computer to USE a module. A module is a program (sub¬ 
program) within a program. 

Every module must begin with a * LABEL and must end with an E:. Figure 2-25 shows 
a module that draws a triangle. 
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108 «TRIANGLE 

110 GR : 3CDRAH 30.: TURN 120J 

120 E: 

READY 


Figure 2-25 


If you type U: Jfc LABEL in Immediate mode, you can check out a module without run- 
ing the entire program. For example, Figure 2-26 is the result of typing 
U: * TRIANGLE. 



Figure 2-27 shows the Jfc TRIANGLE module within a larger program. When the Com¬ 
puter sees U: % TRIANGLE, it jumps to the Statement labeled sfc TRIANGLE and uses 
that module. At the end of the module, the Computer continues with the command 
following U: * TRIANGLE. 


10 RlWHEEL OF TRIANGLES 
20 C:«T=0 
30 GRiCLEAR 
40 «AGAINC:«T=BT+1 
50 U:»TRIANGLE 
60 GR:TURN 36 
70 JCAT<10J :*AGAIN 
80 E: 

100 «TRIANGLE 

110 GR : 3CDRAH 30; TURN 120) 

120 E: 

READY 


Figure 2-27 


Use 
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The program in Figure 2-27 uses the Hs TRIANGLE module ten times to draw a wheel 
of triangles. The final result of this program is shown in Figure 2-28 below. 



Figure 2-28 


Figure 2-29 shows a program that uses several modules ( Hs BOX, Hs TRIANGLE, 
Hs MOON, and Hs STAR) to make a picture. 


10 R:PICTURE 
20 GRiCLEAR 
30 GR : GOTO -25..—10 
40 GR:PEN BLUE 
50 U:«BOX 

60 GR:TURNTO 30;GO 25 

70 GR : PEN RED 

80 U:»TRIANGLE 

90 GR : GOTO O.. 25 

100 GR:PEN YELLOH 

110 U:*MOON 

120 GR:GOTO-40,25 

130 U:*STAR 

140 GR:GOTO -10,35 

150 U:«STAR 

160 GR:GOTO 35,20 

170 U:*STAR 

299 E: 

400 «BOX 

410 GR:TURNTO 90 

420 GR : 3(DRAH 25; TURN 90) 

430 GR:FILL 25 
440 E : 

500 «TRIANGLE 
510 GR:TURNTO 150 

520 GR : 2CDRAH 25; TURN 120) ;FILL 24 
530 E: 

600 «MOON 

610 GR:TURNTO 70 

620 GR : 38CDRAH 1; TURN 5) 

630 GR:TURNTO 5@ 

640 GR : 5CTURN -20; FILL 5) 

650 E: 

700 «STAR 

710 GR : 5CDRAH 10; TURN 144) 

720 E : 

READY 
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Figure 2-29 


Note: It is possible to have modules used within modules up to eight layers deep. For ex- 
ample, the TRIANGLE module could itself use a sj« FILL module; the Jfc FILL 
module could use a Jfc PENCOLOR module, and so on. 
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R: 

Remark 


The R: (REMARK) command lets you say something about the program. However, any 
REMARKS made will be ignored by the Computer when you RUN the program. The only 
time you see them is when you LIST the program onto the tele Vision screen. For exam- 
ple, Figure 2-30 is a program made up almost entirely of REMARKS. 


10 R:************************* 
28 R:* * 

30 R:* * 

40 R:* THE HOTHING PROGRAM * 
50 R:* * 

60 R:* * 

70 R;************************* 
80 T:CTHIS 15 ALSO A REMARK] 

SO T:THI5 PROGRAM DOES NOTHING. 
100 R:THAT'S FOR SURE! 

110 R : THIS IS THE END OF THE 
PROGRAM. 

120 E: 

READY 


Figure 2-30 


Note: Square brackets [ ] are used to indicate a remark on the same line as a command 
as shown in line 80 above. 


When you type RUN and press 


RETURN 


Figure 2-31 is all you will see on the screen. 



Figure 2-31 


REMARKS are particularly helpful when you write longer programs because they will re- 
mind you how the program works long after you have written it. 


30 Remark —R: 
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_ AUTO _ 

Automatic Line Numbering 


Use the AUTO command when you want to type a program into the Computer memory. 
AUTO automatically numbers your program lines for you. 


While you are in the AUTO mode, the Computer will make everything you type part of 
your program. No Immediate mode commands can be entered until you exit from the 
AUTO mode by pressing the BHSflBSfiB key. 


When you type AUTO your screen turns yellow as in Figure 3-1. When you leave the 
AUTO mode, your screen turns blue. 



ATARI PILOT tCJ COPYRIGHT ATARI 1980 


REAOV 

AUTO 


Figure 3-1 


Remember that the Computer enters the line numbers, which you cannot see until you 
exit from the AUTO mode and LIST the program. 
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Figure 3-2 shows a program entered in the AUTO mode. 



Figure 3-2 



READY 

LIST 

16 R:RIDDLEPROGRAM 

26 T : HI. MHAT 1 S YOUR NAME? 

36 A:SNAME 

46 T:OK, $NAME, HERE■SAQUESTION 
i FOR YOU 

58 *GUESSAGAIN 

66 T : WHAT KIND OF OF INSECT LIMES ON 
THE MOON? 

76 A: 

86 M:LUNATIC,LUNE-A-TIC,LOONATIC. 
LOON- A-TIC 

j 96 TN:NOPE. GUESSAGAIN. 

166 JN:«GUESSAGAIN 

116 TY:CONGRATULATIONS. YOU GOT IT! 
126 T : SEE YOU AROUND . 

138 E: 

■ 


Figure 3-3 


You can teil the AUTO command where to start numbering and by how much to increase 
each new line number. For example, AUTO 100,20 teils the Computer to begin number¬ 
ing at 100 and increase each line by 20 (if you leave off the second number, it will 
automatically increase by 10’s). 
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RUN 

Run a Program 




The RUN command teils the Computer to execute the program currently in memory. 
Figure 3-4 shows a listed program and Screen 3-5 shows the program after RUN is typed. 
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LIST 

10 R : 5PINNING RECTANGLE 
20 GR:CLEAR 
30 C:«C=0 

40 GR:G0T0 -15,,-5;TURNT0 -60 
50 «AGAIN 

60 GR : 2CDRAM 25.:TURN 90 :DRAM 10 : 
TURN 90) 

70 GR: TURN 20;DRAM 7 

80 c: wcmc + l 

90 J CttC < 18 ) : «AGAIN 
100 E : 


READY 

■ 



Figure 3-4 



I 
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LIST 

List a Program 
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LIST teils the Computer to display the program currently stored in memory. Use this com- 
mand anytime you need to see the entire program, a few lines of the program, or just 
one line of the program. For example, Figure 3-6 shows the listing of an entire program. 


LIST 

10 R : DRAGON * S TAIL 
20 GR:CLEAR 

30 GR:GOTO -80/-30;TURNTO 90 
40 C:«S=1 
50 »AGAIN 

SO GR:5CDRAMnS;TURN-72) 

70 GR: DRAM 9;TURN -»S/3 
80 C : HS=t»S + l 
90 JC»S<36> :«AGAIN 
100 E: 

READY 

■ 


Figure 3-6 


The command LIST 40,80 teils the Computer to start listing at line 40 and end at line 80, 
as you see in Figure 3-7. 


LIST 40^80 
40 C:ttS=l 
50 *AGAIN 

60 GR : 5 t DRAM ttS/TURN -72) 
70 GR : DRAM 9/TURN -ttS/3 
80 C:ttS=ttS-l-l 

i 

READY 

■ 



Figure 3-7 
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The command LIST 50 teils the Computer to LIST only line 50, as you see in Figure 3-8. 



Figure 3-8 


Note: To get a printed listing of your program on paper, you must SAVE your program 
to the printer (see the SAVE command). 


38 Executive Commands — LIST 







_R|N_ 

Renumber a Program 


The REN command renumbers the program Statements, beginning with the first line of the 
program. It renumbers the lines by 10’s, starting at 10, so you can add more lines of pro¬ 
gram if necessary. Figure 3-9 shows a program before renumbering. 



1 R:SILLY filDDLE PROGRClM 

2 T: 

3 T:HHY ARE ALL BIRDS IN DEBT? 

4 T: 

15 ö: 

16 T: 

17 M! BILLS 

28 TN:NOPE. 

29 TN: BIRDS ARE IN DEBT 

63 TN : BECAUSE THEY ALL HAUE BILLS 
77 TY:THAT-S RIGHT! 

214 E: 


READY 


Figure 3-9 


Figure 3-10 shows the same program renumbered by 10’s starting with 10. 


Mgip 

" . . .- ' -— — r 





- 

REN 

1 


READY 



LIST 



10 R : SILLY RIDDLE PROGRAM 


■■ h ■' ' 

mm 

20 T: 

! 

i 

30 T:WHY ARE ALL BIRDS IN DEBT? 



40 T: 

50 A: 



60 T: 


|ST§| 

70 M: BILLS 



80 TN:NOPE. 

i 

. 

SO TN: BIRDS ARE IN DEBT 


. 

100 TN : BECAUSE THEY ALL HAUE BILLS . 

* 

i; 

110 TY:THAT'S RIGHT! 


| 

120 E: 



READY 



■ 



. •* M **«»~~'**< ■ .....in 

J 


Figure 3-10 
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REN will also let you begin renumbering at any number and increase each Statement by 
any amount you want. For example, REN 100,5 will renumber your program Statements 
starting at 100 and increase each line by 5’s. 

Figure 3-11 shows the program in Figure 3-10 renumbered, starting at 100, increasing by 
5’s. 



REN 1B0..5 



SILLV RIDDLE PROGRAM 
HHY ARE ALL BIRDS IN DEBT? 


BILLS 
NOPE . 

BIRDS ARE IN DEBT 

BECAUSE THEY ALL HAVE BILLS . 

THAT'S RIGHT! 


Figure 3-11 
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NEW 




New Program 
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The NEW command lets you erase the program in the Computer memory. You must be 
careful when you use this command. Make sure you do not want the program any more 
betöre typing NEW. 

Figure 3-12 shows the listing of a program betöre NEW is typed. 



,..._ - ... , rt . r .. .. .. . 

!!T 

r f 

LIST 

1 


10 R : DI5APPEARIMG PROGRAM 



20 T : THIS PROGRÖM 15 «BOUT TO 

30 T:BE CLEAHED OUT OF 

f 

j 

40 T : THE COMPUTER ■ 5 MEMORY. 


f 

50 T : 

1 

! 

60 T i IX THERE 15 ANYTHING UALUABLE 

70 T:HERE, IT SHOUL&FIBST BE 

■ 

| 

80 T:SAVED TO CA55ETTE OR DI5K 

90 T : BEXORE THE COMMAND., ' "NEW ' 


f 

1 

! 

100 T:15 TYPED. 

110 E : 



READY 



■ 



Figure 3-12 


Figure 3-13 shows the attempted listing of a program after NEW is typed. 



Figure 3-13 
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VNEW 

New Variables 


The VNEW: command clears the numeric and/or string variables by using the command 
as follows: 


VNEW:$ (clears the string variables) 

VNEW:# (clears the numeric variables) 

VNEW: (clears both string and numeric variables) 


The VNEW: command does not erase the program from memory. 
Figure 3-14 shows a program with string and numeric variables. 



< H, 

! 


10R I 

2« TS 


.30 

40 

.50 

60 

70 


00 M: 
90 TV 
.95.' TM' 

URN 

100 A 
HO T 
120 E 

RE0IOY 

■ 


INFORMATION 

WHAT 15 YOUR NAME? \ 

5NAME 

HOW OLD ARE YOU? \ 

0A 

DO YOU READ COMIC BOOKS? \ 
SCOMICS 

V, SURE OF COURSE j. 50ME,, OCC 
! WHO 15 YOUR SUPER HERO? \ 

: 50RRY ABOUT THATj. PRESS RET 


: SHERO 
; THANK YOU 


Figure 3-14 
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Figure 3-15 shows the variables with values assigned. 




MHAT 15 YOUR NAME? 5ARAH 

HOM OLD ARE YOU? 12 

DO YOU READ COMIC B00K5? SURE I DO 

MHO 15 YOUR SUPER HERO? A5TR0 MOMAM 

THANK YOU 

READY 


■ V \ '*■ 


— 
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Figure 3-16 shows the variables after VNEW has been typed. 



READY 

VNEW 


READY 
T:SNAME 
SNAKE 


T:SCOMICS 
SCOMXCS 




T:SHERO 

SHERO 


Figure 3-16 
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DUMP 


Dump String Variables 


If you want to see the contents of all the string variables in the computer’s memory, type 
DUMP and press the ItBflfM key. The DUMP command does not clear the memory, 
and therefore is helpful when you want to find errors in your program. 


The program in Figure 3-17 is a listing of a program. 


10 R:AMADLIB 

20 T:PLEASE ANSWER THESE 

OUESTIONS: 

30 T : NAME AN UGLY COLOR : S. 

40 A:$COLOR 

50 T:NAME A CITY: \ 

60 A:$CITY 

70 T : NAME A FAMOUS MOVIE STARLET? \ 
SO AiSSTARLET 

SO TSWHAT'S YOUR GREATEST FEAR? 

100 A:SFEAR 
110 T : S" [CLEAR SCREEN3 
120 T: NEWS FLASH 

130 T: 

140 T : LAST WEEK^ THE FAMOUS 
ACTRESS,. 

150 T : SSTARLET.. TRAVELED TO SCITY 
160 T :WEARING DARK SUNGLASSES AND A 
170 T:$COLOR HAT SO THAT NO ONE 
WOULD 

ISO T : KNOW THAT SHE WAS AFRAID OF 
ISO TlSFEAR. 

200 T: THE END 

210 E: 

READY 


Figure 3-17 


Figure 3-18 is a RUN of that program. 



PLEASE ANSWER THESE OUESTIONS : 

NAME AN UGLY COLOR : LIME GREEN 

NAMEACITY: SUNNYVALE 

NAME A FAMOUS MOVIE STARLET? MS . 

FORTUNE 

WHAT 1 S YOUR GREATEST FEAR? 

BEING KISSED BY A GIANT FROGH 


Ir 

NS 
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."".' — -- 11111) Ulm. 

) 

, 




NEWS FLASH 

1 

f 

LAST HEEK, THE FAMOUS ACTRESS j, 


1 

MS. FORTUNE, TRAUELED TO SUNNYUALE 



HEARING DARK SUNGLASSES AND A 

1 


LIME GREEN HAT SO THAT NO ONE MOULD 

1 

! 

KNOW THAT SHE WAS AFRAID OF 



BEING KISSED BY A GIANT FROG . 

* 


THE END 



READY 

1 

. 

| 

■ 

1 

I 





Figure 3-18 


Figure 3-19 is a DUMP of the variables in that program. 





DUMP 

$CITY='SUNNYUALE 1 
$COLOR=■LIME GREEN * 

$FEAR= ■ BEING KI3SED BY A GIANT FROG ■ 
$STARLET='MS. FORTUNE' 


) 



Figure 3-19 
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LOAD 

Load a Program 



The LOAD command teils the Computer to LOAD a program you have saved on cassette 
or diskette into the Computer memory. 


LOAD C: _ 

Loading From Cassette 


In order to LOAD a program from cassette (indicated by C:), type LOAD C: and press 
the yaw key. 

The Computer will beep, signaling you to Position the cassette tape and press the PLAY 
button on the cassette recorder. When you are ready, press on the Computer 

console to Start the tape loading. If you turn up the volume control on your television set, 
you will soon hear a series of beeps. This teils you that the cassette is loading properly. 
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LOAD D: FILENAME 

Loading From Diskette 


If you are loading a program saved on a diskette, you must know the name of the pro¬ 
gram. For example, if the name of the program you want to LOAD is COLORS.PLT, 
you would type LOAD D:COLORS.PLT and press the Hfliifi key. The D: teils the 
Computer you are loading from the disk drive. Again, if the volume control is turned up 
on the television set, you will begin hearing a series of fast beeps telling you that a pro¬ 
gram is being loaded. 


MERGING PROGRAMS 

The LOAD command does NOT clear out memory before loading a program. This allows 
you to merge two programs—that is, load one program into memory on top of another 
one. When you merge two programs, the program loaded last will write over and replace 
any Statements having the same line numbers as the first program. 

Note: Unless you want to merge two programs, you should always type NEW to clear 
memory before loading a program. 

Figures 3-20 and 3-21 show two different programs, Program One and Program Two. 


5 R: PROGRAM ONE 
IO R:CITYSCAPE 
20 GR:CLEAR 
30 U:«BUILDINGS 
40 U:*SKY 

50 T: THE CITY AT NIGHT 

80 E: 

10O «BUILDINGS 

110 GR : GOTO 75,.—31.:CLEAR 

120 C:»D=0 

130 C!öL=l 

140 «NEHTBUILD 

ISO C:«C=?\3 + 1 [RANDOM COLOR] 

160 J(BC=8LJ :«NEXT BUILD 
170 GRC8C = 1):PEN RED 
ISO GRC8C=2):PEN YELLOW 
ISO GRC8C=3):PEN BLUE 
200 C:BH=?X15+5 [RANDOM BLDG 
HIDTH 1 

210 C : »Y=?\30 + 5 [RANDOM BLDG 
HEIGHT3 

220 GR : TURNTO 0.IDRAW OY.ITURNTO 
180.IGÜ BY 

230 GR : TURNTO -50;GO ttH^TURNTO 0; 
FILL »Y 

240 C:BD=BD+BH 

258 C:«L=BC 

260 GR:TURNTO 180;GO BY 

270 J(BD<150):«NEHTBUILD 

300 «SKY 

310 GR:PEN YELLOM 
320 C:BN=0 
330 »MORE 
340 C:8H—?\158—75 


350 C:BY=?\50+5 

360 GR : GOTO BK^BY 

370 GR:5CDRAH 4;TURN 144) 

380 C:8N=8N+1 

350 JC8N<203:»MORE 

400 E: 

READY 



Figure 3-20 
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5 R: PROGRAM THO 
300 «SKY 

310 GR:GOTO 30 f 40 

320 U:«MOON 

330 C : 115=0 

340 «MORESTARS 

350 C:BX=?\158-79 

360 C:«Y=?\50+5 

378 C:8C=?\3+1 

380 GRC8C=1):PEN RED 

390 GR(BC=2):PEN BLUE 

400 GRC8C=3) :PEN YELLOW 

410 GR : GOTO BX^BY 

420 C:«s=ns+l 

430 JC8S<70J:«MORESTARS 

440 E: 

450 «MOOH 

460 GR:PEN YELLOW 

470 GR:TURNTO 70 

480 GR : 38 C DRAM 1JTURN 5) 

490 GR:TURNTO50 

500 GR:5CTURN-20^FILL 5) 

510 E: 



READY 


Figure 3-21 


Figure 3-22 shows what happens if you LOAD Program Two on top of Program One. 


5 PROGRAM TWO 
IO R:CITYSCAPE 
20 GR:CLEAR 
30 II : «BUXLDIMGS 
40 U:«SKY 

50 Ti THE CITY AT NIGHT 

80 E: 

100 «BUILDINGS 

110 GR : GOTO 75^-31 JICLEAR 

120 C:»D=0 

130 C:BL=1 

140 «NEXTBUILD 

150 C:UC=?\3 + 1 [RANDOM COLOR] 

160 JC8C=8LJ:«HEXTBUILD 

170 GR£8C = 1J :PEN RED 

180 GRC8C=2) : PEN YELLOW 

190 GR(8C=3J : PEN BLUE 

200 C : BX=?\15 + 5 [RANDOM BLDG 

WIDTH3 

210 C:»Y=?\30 + 5 [RANDOM BLDG 
HEIGHT1 

220 GR : TURNTO 0.:DRQW «Y;TURNTO 
180;GO BY 

230 GR:TURHTO—90JGOBX,?TURNTO 0; 
FILL BY 

240 C:BD=BD+BX 

250 C:BL=BC 

260 GR:TURNTO 180;G0 BY 

270 JCBD<1503:«HEXTBUILD 

300 «SKY 

310 GR : GOTO 30^ 40 

320 U:«MOON 

330 C:BS=0 

340 «MORESTARS 

350 C:«X=?\158—79 

360 C:BY=?\.50 + 5 

370 C:8C=?\3+1 

380 GRCBC=1):PEN RED 

390 GRC8C=2)ZPEN BLUE 


400 GRC8C=3) : PEN YELLOW 
410 GR : TOTO BX .BY 
420 C:BS=BS+1 
430 JtBS<70J .-«MORESTARS 
440 E: 

450 «MOON 

460 GR: PEN YELLOW 

470 GR:TURNTO 70 

480 GR : 38C DRAW 1 ^TURN 5) 

490 GR:TURNTO SO 

500 GR:5CTURN-20 :FILL 5J 

510 E: 

READY 



Figure 3-22 
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SAVE 

Save a Program 



The SAVE command lets you save all or any part of a program you have written. In 
Order to SAVE a program, you must have either-a cassette or disk drive attached to your 
Computer. You can get a printout by saving your program to the printer. 


SAVE C: 

Save to Cassette 


To SAVE a program to cassette, type SAVE C:. The Computer will beep twice, which 
teils you to Position the cassette type, and press the PLAY and RECORD buttons (at the 
same time). Then press the B3S8EB8 ' key on the Computer console to begin saving your 
program. As this occurs, you will hear a high-pitched hum and a series of low beeps. 
When you SAVE to cassette in PILOT, you cannot give the program a name. You must 
make a note as to the location of the program on the tape by the numbers shown in the 
counter window on the recorder. Then when you want to LOAD the program back into 
memory, you must first move the tape until that number shows in the counter window. 

If you want to SAVE only part of your program, you need to type the line numbers you 
want saved. For example, typing SAVE C:10,50 will SAVE lines 10 through 50 to the 
cassette. 


Executive Commands — SAVE, SAVE C: 51 
























SAVE D:FILENAME 
Save to Diskette 


If you are saving to a diskette, you must give the program a name of up to seven 
characters. You can extend the program name by adding a period and three more 
characters. This is helpful if you have more than one Version of a program. For example, 
if Version 3 of your COLOR program was in memory and you wanted to SAVE it on a 
diskette, you might type: 

SAVE D:COLORS.V03 

The disk drive will start humming, and if your television volume control is turned up 
slightly, you will hear the beeps telling you that the program is being saved. 

If you are saving only part of the program to diskette, you need to type in the lines you 
want saved after the program name. For example, typing SAVE D:MODULEl 10,50 will 
SAVE only lines 10 through 50 on the diskette under the program name, “MODULEI.” 


SAVE P: 

Save to Printer 


To get a listing of part or all of your program printed on paper instead of the television 
screen, you must SAVE your program to the printer. To get a listing of your whole pro¬ 
gram, turn on the printer, and type SAVE P:. If you only want a listing of lines 20 
through 50, type SAVE P:20,50. 
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_DOS_ 

Disk Operating System 


When you want to work with your disk files for any reason, type DOS and press 
This will bring up the DOS Menu (Figure 3-23) to your television screen. 



f DISK OPERATING SYSTEM II VERSION 2 . OS 
COPYRIGHT 1980 ATARI 

A. DISK DIRECTORY X. FORMAT DISK 

B. RUN CARTRIDGE J. DUPLICATE DISK 

C. COPY FILE K. BINARY SAVE 

! D. DELETE FILEtSJ L. BINARY LOAD 

E. RENAMEFILE M. RUN AT ADDRESS 

F. LOCK FILE N. CREATE MEM. SAV 

G. UNLOCKFILE O. DUPLICATEFILE 

H. WRITE DOS FILES 


SELECT ITEM OR lÜStiUa!» FOR MENU 


Figure 3-23 


Select the function you want to perform from the DOS Menu, type the letter for that func- 
tion, and press 


RETURN 


For example, if you want to see what files are in the Disk Direc¬ 
tory, you would type the letter A (see DOS Menu) and press jßTäflBffl twice. You will then 
see a listing of all the files in the directory (Figure 3-24). Our sample Disk Directory is 
listed on the following page; yours will have different filenames. 
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■ 

•—inTiTnwtifmMntiMBBlOüiiE 

DOS 

SYS 039 

DIIP 

SYS 842 

PILTDEM 

TIA 058 

VINCE 

PLT 003 

PILTDEM 

T1B 032 

j PILTDEM 

T2A 056 

i PILTDEM 

T2B 048 

256 FREE SECTORS 

SELECT ITEM OR FOR MENU 

■ 

. 



Figure 3-24 
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4 GRAPHICS 












GR: 

Graphics 



The GR: (GRAPHICS) command teils the Computer you are going into the Graphics mode 
to draw a picture. Figure 4-1 shows you what the basic Graphics screen looks like. 



Figure 4-1 


The black background is for drawing, and the blue strip at the bottom of the screen (the 
text window ) is for displaying messages or writing commands. 
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TURTLE GRAPHICS 


The method by which you draw is called turtle graphics. Imagine that the screen is the 
playground of an invisible turtle who draws on the screen with a tiny pen. The 
GRAPHICS commands teil the turtle where to go and what to do with the pen. 

The GR: command does not draw anything by itself; it must be used with Graphics Sub- 
commands. For example, the PEN Subcommand teils the turtle either to lift the PEN or to 
draw in one of four colors. The Graphics Subcommands are explained in more detail on 
the pages to follow. 

Commanding the turtle to move is like giving someone directions to the nearest gas Sta¬ 
tion: either you give directions where (go to Fourth and Main St.), or you give specific 
directions which way and how far (go 3 blocks to Fourth, take a right and go 4 blocks to 
Main St.). 


WHERE TO GO - X AND Y COORDINATES 

The Graphics screen is really an invisible grid of numbered lines which looks like a piece 
of graph paper. The center of the screen is a point (called the origin) where the X and Y 
axes cross. 

The X axis goes horizontally from the left (-79) to right ( + 79). The Y axis goes vertically 
from the bottom of the screen (-47) to the top of the screen (+ 47). The bottom of the 
screen includes the text window. 

Every point on the screen is named by two numbers (X,Y). These two numbers are called 
the X and Y Coordinates of the point. They teil the distance horizontally and vertically 
from the point to the origin. Figure 4-2 shows the screen layout with some labeled points. 



Figure 4-2 
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The Graphics Subcommands GOTO, DRAWTO, and FILLTO use Coordinates to teil the 
turtle where to go. 


WHAT DIRECTION AND HOW FAR TO GO 

The turtle is always at the center of an invisible circle which moves with him wherever he 
goes. This circle is divided into 360 one-degree angles, with the 0-degree angle pointing 
up. 

The turtle is always pointing in some direction within this circle, and can turn to the right 
( + ) or left (-) in 360 different angles. Figure 4-3 shows some different headings. The 
Graphics Subcommands TURNTO and TURN, change the turtle’s direction. 



Figure 4-3 


Each step the turtle takes, either forward or backward, is called a turtle unit. The units 
are the same size as the individual units making up the invisible grid; therefore, if the tur¬ 
tle moved from the origin to the right edge of the screen, he would move 80 turtle units. 
The Graphics Subcommands GO, DRAW, and FILL teil the turtle to move forward or 
backwards in whatever direction he is facing. 


INITIAL LOCATION, HEADING, AND PEN COLOR 

When you first enter the Graphics mode, the turtle is located at 0,0 (the origin). He is fac¬ 
ing 0 degree (straight up) and the PEN color is yellow. 
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SHORTCUTS FOR GRAPHICS PROGRAMMING 



You can program more than one GRAPHICS subcommand in the same program State¬ 
ment. Each subcommand MUST be separated by a semicolon (;). For example: 


GRrGOTO 0,0; DRAW 10; TURN 45; PEN RED; DRAW 5 


If you want a series of subcommands repeated a specific number of times, enclose the 
series of subcommands in parentheses and precede the left parenthesis by the number of 
times you want that series repeated. For example, the program in Figure 4-4 shows the 
long way to draw a box. The program in Figure 4-5 shows a short way to to draw the 
same box. 


10 R : LONG MAY BOX 
20 GR:CLEAR 
25 GR:GOTO-15 H -5 
30 GR:DRAM 30 
40 GR:TURN 90 
50 GR:DRAM 30 
60 GR:TURN 90 
70 GR: DRAM 30 
80 GR : TURN 90 
90 GR:DRAM 30 
100 GR:TURN 98 
110 E: 

READY 



Figure 4-4 



Figure 4-5 
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GR:CLEAR 

Clear the Graphics Screen 



GR:CLEAR erases what is on the screen. When you enter a new GR: command the pic- 
ture begins at the point you left off with the last drawing. 


Figures 4-6 through 4-8 show you how GR:CLEAR can be used in a program. The pro¬ 
gram draws a pentagon, pauses for you to look at it, then clears the screen and draws a 
star. The program continues to go back and forth between the pentagon and the star, giv- 
ing you a flashing effect. 


10 R : THE PENTAGON AND THE STAR 

20 GR:CLEAR 

30 »LOOP 

40 U:»PENTAGON 

50 PA:5 

60 GR:CLEAR 

70 II: »STAR 

80 PA:5 

90 GR:CLEAR 

100 J:»LOOP 

110 »PENTAGON 

120 GR : GOTO -15,0 

130 GR : TURNTO -18 

140 GR:5CDRAM 20;TURN 72) 

150 E: 

160 »STAR 

170 GR : GOTO -15,0 

180 GR:TURNTO 19 

190 GR : 5CDRAM 31;TURN 144) 

200 E: 


READY 
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Figure 4-6 



Figure 4-7 



Figure 4-8 
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_ GR:GOTO _ 

Go to the Point X,Y * 
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The command GR:GOTO X,Y teils the turtle to pick up the pen, move to the point with 
Coordinates X and Y, and put the pen down there. The pen leaves a dot on the screen at 
the point (X,Y). Figure 4-9 is a short program that makes “The Big Dipper” using GOTO 
commands. 


le R : THE BIG DIPPER 

15 GR:CLEAR 

20 GRrGOTO 40..40 

30 GR : GOTO 20^35 

40 GR:GOTO 5^25 

50 GR:GOTO —lOj.10 

60 GR : GOTO —10^—5 

70 GR : GOTO -30,-10 

80 GR : GOTO —40 ^ 5 

90 T: THE BIG DIPPER 

100 E: 

READY 


THE BIG DIPPER 


READY 


Figure 4-9 


The X and Y Coordinates in the GOTO command may either be numbers, numeric 
variables, or numeric expressions. The program in Figure 4-10 uses numeric variables #X 
and #Y as Coordinates. These variables are given random values so the dots appear at 
random on the screen. (The color of the dots is also chosen at random.) 


10 R: NIGHT SKY 
20 GR:CLEAR 

30 T: NIGHTSKY 

40 C:«s=o 
50 »MORE 

60 C:»X=?\158-79 
70 C:»Y=?\47 
80 C:«C=?X3+1 
90 GRt«C = lJ:PEN RED 
100 GRCttC=2):PEN BLUE 
110 GRC»C=3):PENYELLOW 
120 GR : GOTO ttX^ttY 
130 C:HS=BS+1 
140 J(»S<ie03:»MORE 
150 E: 

READY 



Figure 4-10 
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GR:PRAWTO 

Draw to the Point X,Y 





The command GR:DRAWTO X,Y teils the turtle to put the pen down and draw a straight 
line to the point with Coordinates X and Y. The line is drawn in the pen’s current color, 
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and the turtle ends up at point X,Y. For example, the program in Figure 4-11 uses 
DRAWTO to make the outline of a barn. 


10 

R:BORN 


20 

GR : 

CLEOR 


30 

gr : 

PEN RED 


40 

GR: 

GOTO — 30 , 

40 

50 

GR: 

DROHTO 45 

,40 

60 

GR: 

DROMTO 60 

,25 

70 

GR: 

DROHTO 65 

, 5 

80 

GR: 

DROHTO 65 


90 

GR: 

DROHTO 65 

,-30 

100 

GR 

:DROHTO - 

10,-30 

110 

GR 

:DROHTO - 

10,5 

120 

GR 

:DROHTO - 

15,25 

130 

GR 

:DROHTO - 

30,40 

140 

GR 

: DROH TO - 

-45,25 

150 

GR 

:DROHTO - 

50,5 

160 

GR 

:DROHTO - 

50,-30 

170 

GR 

:DROHTO - 

10,-30 

180 

GR 

: GOTO 65 , 

5 

190 

GR 

:DROHTO - 

50,5 

200 

GR 

: GOTO -35 

,30 

210 

GR 

:DROHTO - 

25,30 

220 

GR 

:DROHTO - 

25,15 

230 

GR 

:DROHTO - 

35,15 

240 

GR 

:DROHTO - 

35,30 

250 

GR 

: GOTO -40 

,-30 

260 

GR 

:DROHTO - 

40,-10 

270 

GR 

:DROHTO - 

20,-10 

280 

GR 

:DROHTO - 

20,-30 

290 

E : 



REODY 



■ 






Figure 4-11 


The X and Y Coordinates in the GOTO command may either be numbers, numeric 
variables, or numeric expressions. The “Modern Art 1” program in Figure 4-12 uses 
numeric variables #X and #Y as Coordinates. These variables are given random values 
so the lines are drawn at random. The colors of the lines are also chosen at random. 


18 R : MODERN ORT I 
20 *BEGIN 
30 GR:CLEOR 
40 T: 

50 T: MODERN ORT 

60 C:»L=?\200+7 
70 C:»S=0 
80 «MORE 

90 C:»X=?\158-79 
100 C:«Y=?\94-47 
110 C:»C = ?S.4 
120 GRCHC = 0) : PEN UP 
130 GRCttC = l) : PEN RED 
140 GRC»C = 2) : PEN BLUE 
150 GRC»C = 3) : PEN YELLOH 
160 GR : DROMTO «H,»Y 
170 c:«s=t*s + i 
180 JC»3<»L) :*MORE 
190 POi1000 
200 J:*BEGIN 

REODY 



Figure 4-12 
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GR:FILLTO 

Rll to the Point X,Y 


The command GR:FILLTO X,Y teils the turtle to draw a line to the point with Coordinates 
X and Y. As he moves, the black background between the turtle and any figure or line 
directly to his right is filled with the current pen color. Figure 4-13 shows how FILLTO is 
used to fill parts of a barn in red. 


16 R : RED BARN 
28 GR:CLEAR 
30 GR : PEN RED 
40 GR:GOTO —30,40 
50 GR : DRAMTO 45,40 
60 GR:DRAMTO 60,25 
70 GR : DRAMTO 65,5 
80 GR : DRAMTO 65,5 
90 GR:DRAMTO 65,-30 
100 GR:DRAMTO-10,-30 
110 GR : FILLTO -10,5 
120 GR:FILLTO-15,25 
130 GR:FILLTO -30,40 
140 GR:DRAMTO-45,25 
150 GR: DRAMTO -50,5 
160 GR:DRAMTO-50,-30 
170 GR:DRAHTO-10,-30 
180 GR : GOTO 65,5 
190 GR: PEN ERASE 
200 GR : DRAMTO -10,5 
210 GR : PEN RED 
220 GR: DRAMTO -50,5 
238 GR:GOTO-35,30 
240 GR:DRAMTO -25,30 
250 GR:DRAMTO-25,15 
260 GR:DRAMTO-35,15 
270 GR:FILLTO -35,30 
280 GR:GOTO -20,-30 
290 gr:dramto- 20,-10 
300 GR:DRAMTO-40.-10 
310 GR:FILLTO -40,-30 
320 E: 



READY 


Figure 4-13 


If there is nothing to block the color filling in betöre it reaches the right edge of the screen, 
the filling “wraps around,” and color continues to fill in from the left edge until a barrier is 
reached. When there is nothing blocking the fill anywhere in its path, the line being filled 
from becomes its own barrier. This is shown in Figure 4-14. 
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10 R:FILLIMG UP SPACE 

20 GR:GOTO 30.. 45.:TURNT0 180.: PEN 

YELLOU 

30 U:«PARTBQX 

40 GR:GOTO -40.. 15TURNTO 90,: PEN 
YELLOW 

50 U:«PARTBOX 

60 GR : GOTO -50,-20 JTURNTO 30.:PEN 
YELLOW 

70 U:«TRIANGLE 

80 GR : GOTO 15/0;TURNTO 90.:PEN 

YELLOW 

SO U:«BOX 

100 GR:GOTO 50^5;TURNTO -30JPEH 
YELLOW 

120 U:»TRIANGLE 

200 GR : GOTO -50J.-30 

210 GR : PEN RED 

220 GR : FILLTO SO..30 

230 GR : PEN YELLOW^GOTO 51..31 

299 E : 

400 «BOX 

410 GR : 4CDRAW 10;TURH 90) 

420 E: 

500 «PARTBOX 

510 GR:3(DRAW 20 JTURN 90) 

520 E: 

600 «TRIANGLE 

610 GR : 3CDRAW 15 JTURN 120) 

620 E : 



READY 


Figure 4-14 


FILLTO, like GOTO and DRAWTO, may use either numbers, numeric variables, or 
numeric expressions as Coordinates. 
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GR:TURNTO 


Turn to N Degrees 





The command GR:TURNTO N teils the turtle to turn in place until he is heading toward 
the angle N degrees. The top of the screen is 0 degree. Positive angles ( + ) aremeasured 
clockwise from 0 degree; negative angles (-) are measured counterclockwise. 

Since the turtle is in visible on the screen, you cannot see him turn, but you can see the 
direction of his new heading by executing a GO, DRAW, or FILL command after the 
TURNTO. Figure 4-15 shows a program that uses TURNTO to let you make a design on 
the screen with right angles and 10-unit lines. 


10 RlSKETCHING PROGRAM 
28 T i THIS PROGRAM LETS YOU DRAM A 
30 T:DESIGN ON THE GRAPHICS 
SCREEN 

40 T:USING THE COMMANDS: 

50 T: 

J\P 

HOHN 
ylGHT 

Seft 

S0LEAR 
110 T: 

120 T : PRESS RETURN TO BEGIN . . . 
130 A: 

140 «BEGIN 
150 GR:CLEAR 

160 T:STARTING H LOCATION? \ 

170 A:»K 

180 T : STARTING V LOCATION? S. 

190 A:«Y 

200 GR:GOTO ttH^ttY 
210 «COMMAND 

220 T:HHICH HAY tffl 0 □ H OP 0LE AR J ? 
230 A: 

240 M: 11, D f ß„. L,. C 

250 JM:«UP ^«DOHN „.«RIGHT ^«LEFT f 

«BEGIN 

260 «UP GR : TURNTO 0 
270 J:«LINE 

280 «DOHN GR:TURNTO 180 

290 J:«LINE 

300 «RIGHT GR:TURNTO 90 


310 J:«LINE 

320 «LEFT GR:TURNTO -90 
330 «LINE GRlDRAH 10 
340 J:«COMMAND 

READY 
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Figure 4-15 


The directional angle, N, in the GR:TURNTO N command may be either a number, a 
numeric variable, or a numeric expression. The program in Figure 4-16 uses TURNTO 
with the numeric variable, #T, to create a starburst pattem with lines coming out from the 
origin every 5 degrees. 



10 R:STARBURST 
20 C:«T=0 
25 GR:CLEAR 
30 »LOOP 
40 GR : GOTO 0^0 
50 GR:TURNTO «T 
60 GR : GO 3^DRAM 25 
70 C:«T=«T+5 
80 JC8T<360):*LOOP 
90 E : 


READY 



READY 


Figure 4-16 
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GR:TURN 

Turn N Degrees 




The command GR: TURN N teils the turtle to turn N degrees clockwise ( + N) or 
counterclockwise (-N) from the direction he is currently facing. Since the turtle is in visible 
on the screen, you cannot see him turn, but you can see the direction of his new heading 
by executing a GO, DRAW, or FILL command after the TURN. Figure 4-17 shows a pro¬ 
gram that makes a 13-pointed star with a 166-degree turn at each point. 


10 R:13-PÖINTED STAR 

20 C:öC=0 

30 gr:clear 

40 GR:GOTO -10,-5 

SO GR:TURNTO 14 

60 »LOOP 

70 GR:DRAM 50 

80 GR : TURN 166 

90 C:«C=»C+1 

100 JC«C<14) : »LOOP 

110 E: 

READY 



Figure 4-17 
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The directional angle N, in the TURN (N degrees) command can be either a number, a 
numeric variable, or a numeric expression. The program in Figure 4-18 draws first a 
triangle, then a square, then a pentagon, and so on, all on top of each other. The 
amount the turtle turns in line 90 is 360 degrees divided by the number of sides in the 
polygon he is currently drawing. 


10 R:EUCLID 
20 C : 1*5 = 3 
30 GR:CLEAR 
40 »BEGIN 
50 C:»C=0 
50 GR:GOTO 10^-30 
70 GR:TURNTO -90 
80 »LOOP 

90 GR : DROH 28TURN 360/ttS 

100 c:nc=ttc + l 

110 JCttC<»5>:»LOOP 
120 C : BS=t*S + l 
130 Jt»S<21>:»BEGIN 
140 E : 

READY 



Figure 4-18 
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GR:GO _ 

Go N Units % 
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The GR:GO N command teils the turtle to pick up the pen, move N units in the direction 
he is facing, and put the pen down there. The turtle leaves a dot on the screen at the loca- 
tion where he ends up. The program in Figure 4-19 uses the GO command to draw a 
box with dotted lines. 


10 R:DOTTED BOH 
20 GR:CLEAR 

30 GR : 4C10CG0 3J jlTURH 90J 
40 E: 

READY 



Figure 4-19 



The number of units, N, in the GR:GO N command can be either a number, numeric 
variable, or a numeric expression. The program in Figure 4-20 teils the turtle to take a 
“random walk.” That is, he Starts at the origin, turns a random number of degrees, goes a 
random number of units, turns at random again, moves at random again, and so on. At 
the end of this walk, all the places he stopped and turned are marked by dots on the 
screen. 


10 R: random walk 
20 «BEGIN 
30 c:«c=o 
40 GR:CLEAR 

SO T: RANDOM KALK 

SO GR:PEH YELLONJGOTO 0,0;PEN RED 

70 «LOOP 

80 GR : GO ?\5 

90 GR : TURN ?\360 

100 c:nc=nc+i 

110 JC«C<500) :«LOOP 

120 T: 

130 T:END OF MALK 
140 PA:900 
ISO J:«BEGIN 

READY 



Figure 4-20 
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GR:DRAW 

Draw N Units 





74 Graphics —GR: DRAW 







The command GR:DRAW N teils the turtle to draw a line, N units long, moving in the 
direction he is currently facing. The line is drawn in the current pen color. The program in 
Figure 4-21 uses the DRAW and TURN commands to make a simple house. 


18 R : SIMPLE HOUSE 
20 GR:CLEAR 
30 T: HOUSE 

40 GR:GOTO-15^10 
50 GR:TURHTO SO 
60 GR : DRAM 30.: TURN SO 
70 GR : DRAM 30JTURH SO 
80 GR : DRAM 30.: TURN SO 
SO GR : DRAM 30JTURH 30 
100 GR : DRAM 30.: TURN 120 
110 GR : DRAM 30/TURN 120 
120 E: 

READY 



Figure 4-21 


The number of units, N, in the GR:DRAW N command can be either a number, a 
numeric variable, or a numeric expression. Figure 4-22 shows a program that draws 
spirals at any angle you choose. Each time the turtle turns, the side of the spiral grows 
longer by the amount you type into the Computer. 


10 R:SQUIRAL 
20 GRlCLEAR 
30 MBEGIN 

40 T: SQUIRAL 

50 T: 

60 TlTURNING ANGLE C1-17S)? X 
70 A:HA 

80 T:SPEED OF GROWTH C1-10J? X 
SO A:«I 

100 GR:CLEAR^GOTO O^O^TURNTO 0 
110 T: SQUIRAL 

120 T: 

125 T: ANGLE = HA GROHTH=«I 

130 c:ns=o 
140 »MORE 

150 GR : DRAM US J TURN HA 
160 C:«S=»S+«I 
170 JCttS<200) : »MORE 
180 T:AGAIN?X 
ISO a: 

200 M: Y^SURE^OK^ALRIGHT 
210 JY:»BEGIN 
220 GR:QUIT 
230 E: 



READY 


Figure 4-22 
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GR:FILL 

ill N Units 


The GR:FILL N command teils the turtle to draw a line, N units long, moving in the 
direction he is currently facing. As he moves, the black background between the turtle and 
any figure or line directly to his right is filled in with the current pen color. Figure 4-23 
shows how FILL can be used to draw a solid triangle, square, or circle. 


10 R:SOLIDS 
28 GR:CLEAR 

30 T: TRIANGLE SQUARE CIRCLE 
40 GR : GOTO -50^8;TURNTO 150.:PEN 
RED 

50 U:»TRIANGLE 

60 GR:GOTO-15/10;TURNTO90^PEN 
BLUE 

70 U:»SQUARE 

80 GR:GOTO40 / 10jTURNTO90JPEN 
YELLOW 

90 U:»CIRCLE 
100 E: 

200 »TRIANGLE 

210 GR : 2 ( DRAM 20 J TURN 120) 

220 GR : FILL 19 
230 E: 

300 »SQUARE 

310 GR : 3 ( DRAM 20 J TURN 90) 

320 GR : FILL 20 
330 E: 

400 »CIRCLE 

410 GR : 18 ( DRAM 2/TURN 10) 

420 GRI18CFILL 2;TURN 10) 



READY 


Figure 4-23 


Note: To color in a polygon (such as a triangle, square, or circle) using the FILL com¬ 
mand, you must first DRAW the right half of the polygon and then FILL the left half. 
Sometimes, the filled side must be shorter than the drawn side so that the color will be 
completely contained within the figure. For example, in Figure 4-23, the two drawn sides 
of the triangle are 20 units long, whereas the filled side is only 19 units long. 

If there is nothing to block the color filling in before it reaches the right edge of the screen, 
the filling “wraps around,” and color continues to fill in from the left edge until a barrier is 
reached. When there is nothing blocking the fill anywhere in its path, the line from which 
the filling takes place becomes its own barrier. The “Sunset” program in Figure 4-24 
shows how FILL can be used to fill large areas of the screen with color. 
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10 R:5UNSET 
15 GR.'CLEAR 
20 U:*3UN 
30 U:*REDCLOUDS 
40 U:*SKY 
45 U:*SUNBATH 
50 E: 

100 *5UNBATH 

110 GR:GOTO 0^-13,TURNTO 180.:PEN 
YELLOW 

120 GR:FILL 26 
130 E: 

200 *SKY 

210 GR : GOTO 0^10 ,:TURNTO 0.:PEN 
BLUE 

220 GR:FILL 37 
230 E: 

300 «SUN 

310 GR : GOTO 0^10;TURNTO ?0 
320 GR : 36CDRAW 1JTURN 5) 

330 GR:36CFILL l;TURN 51 
340 E : 

400 MREDCL0UD3 

410 GR : GOTO 0^10;TURNTO 90.:PEN 
REO 

420 GR:36CFILL l.:TURH 5J 
430 E: 






READY 


Figure 4-24 


The number of units, N, in the GR:FILL N command can be either a number, a numeric 
variable, or a numeric expression. 
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GR:PEN 

Choose a Pen Color 
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The GR:PEN COLOR command teils the turtle to choose a pen color — yellow, red, or 
blue. For example, the program shown in Figure 4-25 draws polka dots in yellow, red, 
and blue in random positions on the screen. 


10 R : POLKA DOTS 
20 »BEGIN 
30 C:«N=0 
40 GR:CLEAR 

50 T: POLKA DOTS 

GO »POLKA 

70 C:öH=?\150—75 

80 C:«Y=?\62-31 

SO C:«C=?\3+1 

100 GRCttC=l):PENYELLOM 

HO GRCttC = 2) : PEN RED 

120 GRCttC = 3):PEN BLUE 

130 GR : GOTO HX ..HY 

140 U:»DOT 

150 C:»N=ttN + l 

160 JC»N<50]:»POLKA 

170 PA:120 

180 J:»BEGIN 

190 E: 

200 »DOT 

210 GR:TURNTO 90 

220 GR:10CDRAH 1;TURN 18J 

230 GRUOCFILL ljTURN 18J 

240 E : 



READY 


Figure 4-25 
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OR.PEN ERASE 

Set Pen Color to Erase 


You can also teil the turtle to draw in the black background color by using the command 
PEN ERASE. This command lets you “erase” anything you have already drawn by 
redrawing it in the black background color. Figure 4-26 shows how the PEN ERASE com¬ 
mand is used repeatedly to draw a star, erase it, and redraw it in a different place. This 
gives the effect that the star is moving. 


18 R : SHOOTING STAR 
20 *BEGIN 
30 C:»C=0 
40 GR:CLEAR 

50 T: SHOOTINGSTARS 

60 GR:GOTO -75^40 

70 GR : TURNT : 120 

80 »LOOP 

90 GR:PEN YELLOM 

100 U:»STAR 

110 GR : PEN ERASE 

120 U:»STAR 

130 GR:GO 5 

140 c:*»c=»c + i 

150 JCOC<32>:»LOOP 

160 PA:120 

170 J:»BEGIN 

180 »STAR 

190 GR : 5 (DRAM 10 J TURN 144) 
200 E: 

READY 




Figure 4-26 
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GR:PEN UP 

Lift the Pen 


The PEN UP command teils the turtle to pick up the pen off the screen. While the pen is 
up, all movement by the turtle will be in visible. To put the pen back “down,” you choose 
a pen color. 
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GR:QUIT 

Quit the Graphics Mode 



The command GR:QUIT lets you leave the Graphics mode and return to Text mode. 
Figure 4-27 shows you the screen before the GR:QUIT command, and Figure 4-28 shows 
you the screen after the GR:QUIT command. 



Figure 4-27 
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5 SOUND AND PAUSE 








SO: 

Sound 


The SO: command lets you create musical tones on your Computer. You can program up 
to four tones to play at the same time. Each separate tone is then called a uoice. When a 
group of people get together to sing, they divide into several uoices : bass, baritone, alto, 
and soprano. When you program SO: commands, you can program several voices to 
play together. When different voices play a sound at the same time, it is called a chord. 

The tones you can play in PILOT ränge from 0 to 31. If you enter the command SO:13, 
you will hear a single tone equal to middle C on a piano. The command SO:l produces 
a tone equal to the note C, one octave below middle C. The command SO:31 produces 
the note F sharp, one octave above middle C. SO:0 turns a tone OFF. 

Figure 5-1 shows a piano keyboard with the key numbers corresponding to the PILOT 
SOUND commands. 


:0 1 2 3 4 5 6 7 8 9(0 II 12 13 14 15 16 17 18 19 20212223 24 25 26 2728 29 30 31 



Typing the commands in Figure 5-2 one at a time will produce a scale. 



Figure 5-2 
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A scale is a series of notes played one after another. Think of a ladder on which you take 
one step at a time to go up or down. A scale is similar, only with musical notes being 
played in a specific order. This particular scale covers the octave between middle C and C 
above middle C. An octave is a ränge of notes from one note to another note of the 
same name (higher or lower). 


The program in Figure 5-3 repeatedly moves up and down the scale shown on page 86. 
When this program is RUN, the Computer moves through the SOUND commands so 
quickly that all the tones blur together, and this scale sounds like a siren. The PA: com¬ 
mands in this program increase the length of time the tones are sounded. Without them, 
this scale sounds like rumbling static. The PA: command is explained later in this section. 


10 

R : SIREN 

20 

MBEGIN 

30 

SO: 

13 

35 

PA : 

1 

40 

SO: 

15 

45 

PA: 

1 

50 

so: 

17 

55 

PA : 

1 

50 

SO: 

18 

65 

PA: 

1 

70 

so: 

20 

75 

PA: 

1 

SO 

SO: 

22 

85 

PA: 

1 

90 

SO: 

24 

95 

PA: 

1 

100 

SO 

: 25 

105 

PA 

: 1 

110 

SO 

: 24 

115 

PA 

: l 

120 

so 

: 22 

125 

PA 

: 1 

130 

SO 

: 20 

135 

PA 

: 1 

140 

SO 

: 18 

145 

PA 

: 1 

150 

SO 

: 17 

155 

PA 

: 1 

160 

SO 

: 15 

165 

PA 

: 1 

170 

SO 

: 13 

180 

SO 

: 0 

190 

J : 

*BEGIN 

READY 



Figure 5-3 


The SO: command lets you create sound effects and tunes in your PILOT programs. 
Figure 5-4 shows how you might use SOUND to reward correct answers in a simple 
geography quiz program. 
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10 R:E-ZGEOGRAPHY 

20 T : WELCOME TO E-Z GEOGRflPHY 

30 T : 

46 T : I Ali GOING TO ASK VOU A 
QUESTION 

50 T:ABOUT UNITED STATES 

GEOGRAPHY 

60 T: 

70 T:ARE YOU READY? \ 

80 A: 

90 T:GOOD 
100 T: 

110 PA: 60 

120 T : WHICH OF THE FIFTY STATES IS 
130 T:LOCATED FARTHE5T TO THE 
EA5T? 

140 T: 

150 A:SST ATE 
160 M: ALASKA 

170 TY:EXTRAORDINARY ! YOU GOT IT ! 

180 UY:»DAHDAH 

190 JY:»THATSALL 

200 T : HOPE , THE ANSMER IS ... \ 

210 PA:30 

220 Ti ALASKA 

230 T : ALASKA EXTENOS SO FAR WEST 
THAT 

240 T : IT GROSSES THE 
INTERNATIONAL 

50 T : DATE LINE INTO THE EAST . 

260 T : 

270 »THATSALL T : 

280 T ! THAT'S ALL FOR NOM. SEE YOU 
AROUND. 

290 E : 


300 »DAHDAH 
310 C:»C=0 
320 »LOOP 

330 SO:13,17,20 .25 
340 PA:15 
350 SO:0,0,0,0 
360 C:«C=öC+l 
370 Jl«C<5J:»LOOP 
380 E: 

READY 


HELCOME TO E-Z GEOGRAPHY 

I AM GOIMG TO ASK YOU A OUESTION ABOUT 
UNITED STATES GEOGRAPHY. 

ARE YOU READY? SURE 
GOOD. 

MHICH OF THE FIFTY STATES IS LOCATED 
FARTHEST TO THE EAST? 

MAINE 

NOPE, THE ANSMER IS . . . ALASKA. 
ALASKA EHTENDS SO FAR MEST THAT IT 
GROSSES THE INTERNATIONAL DATE LINE 
INTO THE EAST. 

THAT ■ S ALL FOR NOM. SEE YOU AROUND 
READY 

■ 


Figure 5-4 


You may use either numbers or numeric variables to teil the Computer which tones to play 
in a SO: command. Values greater than 31 are reduced to numbers between 0 and 31. 


Figure 5-5 shows how the SO: command can be used with a numeric variable to make 
sound effects for the shooting star program of Figure 4-26. 


1 GRIQUIT 

10 R : SHOOTING STAR HITH SOUND 

EFFECTS 

20 »BEGIN 

30 C:«C=0 

40 GR:CLEAR 

50 T: SHOOTINGSTARS 

60 GR:GOTO -75,40 

70 GR : TURNTO 120 

80 C:«S=?\20+1 

90 »LOOP 

100 C:»P=31-»C 

110 SO:«P 

120 GR:PEN YELLOH 

130 U:»STAR 

140 GR : PEN ERASE 

150 U:»STAR 

160 GR:GO 5 

170 c:ac=»c+i 

180 JC«C<32J:»LOOP 

190 PA:240 

200 J:»BEGIN 

210 »STAR 

220 GR : 5CDRAH «5; TURN 144J 
230 E : 



READY 


Figure 5-5 
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PA: 

Pause N Units 



Use the PA:N command when you want a program to PAUSE for any reason during the 
RUN of a program. For example, PA: may be used to freeze what is on the screen for a 
few moments before Clearing the the screen. PA: also allows you to write text on the 
screen a little at a time or to pause for dramatic effect: “The correct answer is.... 
(pause)...An Embarrassed Zebra.” The program in Figure 5-6 pauses for dramatic effect 
before announcing a lucky number in the PILOT Lucky Number Drawing. 


10 R:LUCKY NUMBER 
20 T : WELCOME TO THE PILOT 
30 T!LUCKY NUMBER SWEEPSTAKE5 
40 T : 

50 PA:90 

60 T:NOW GET READY . . . \ 

70 PA:90 

80 T: HERE HE GO. 

80 T : 

100 PA:90 

110 T : ROUND AND ROUND THE CPU GOES 

120 T:WHERE 5HE STOPS, NOBODY 
KNOWS. 

130 T : 

140 PA:90 

150 C:BR=?\30000 

160 T:AND THE PILOT LUCKY NUMBER 
15 . . . 

170 T : 

180 PA:180 
190 T:»R 
200 T: 

210 PA:180 

220 T:C0NGRATULATI0N5 TO THE 
COMPUTER 

230 TiHHOSE SERIAL NUMBER 15 »R. 
240 E : 



WELCOME TO THE PILOT 
LUCKY NUMBER 5WEEP5TAKE5 

NOW GET READY . . . HERE WE GO . 

ROUND AND ROUND THE CPU GOES . . . 
WHERE SHE STOPS, NOBODY KNOWS. 

AND THE PILOT LUCKY NUMBER 15 . . . 

26177 

C0NGRATULATIONS TO THE COMPUTER 
WH05E SERIAL NUMBER IS 26177. 

DFAhV 



READY 


Figure 5-6 
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The units in the PA:N command may either be a number or a numeric variable. Each unit 
is equal to l/60th of a second. Thus PA:60 will pause for 1 second; PA:30 will pause for 
V 2 second; PA:300 will pause for 5 seconds, and so on. 

The PA: command is offen used in combination with the SOUND command to teil the 
Computer how long to sound one or more voices. For example, the program in Figure 
5-7 uses SO: and PA: to add a random three-chord polka to the Polka Dots program of 
Figure 4-25. 



10 R : D0T5 POLKA 
20 «BEGIN 
30 C:ttN = 0 
40 GR:OLE AR 
50 T : 

60 T: DOTSPOLKA 

70 «POLKA 

80 C:»H=?\150-75 

80 C:»Y=?\62-31 

100 C:«C=?\3+1 

110 GR(«C=11:PEN YELLOW 

120 50(00=11:13,17,20 

130 GRCOC = 21:PEN RED 

140 50(00=21:13,18,22 

150 GR(nC = 3) : PEN BLUE 

160 50(ttC = 31 : 15 .20 .24 

170 GR : GOTO «H,«Y 

180 U:«DOT 

180 U:«UMPAH 

200 0 : ttN = t*N + l 

210 J(ttN<50) : «POLKA 

220 U:«FINALE 

230 J:«BEGXN 

240 E : 

300 «DOT 

310 GR:TURNTO 80 

320 GR : 10 ( DR AH ljiTURN 181 

330 GR:10(FILL l^TURN 181 

340 E : 

400 «UMPAH 
410 0 : OR=ttN\3 
420 PA(HR=01:20 
430 50:0 / 0,0 
440 PA(HR=0]:5 
450 E : 

500 «FINALE 

510 50 : 13,17 ,20 

520 PA:60 

530 50:13,18,22 

540 PA;60 

550 50:15,20,24 

560 PA:60 

570 50:13,17,20,25 
580 PA:120 
580 50:0,0,0 
600 PA:480 
610 E : 




READY 


Figure 5-7 
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The SO: and PA: commands can be used together to make 
5-8 shows the PAUSE values for various musical notes. 


music, The table in Figure 


PAUSE VALUES FOR MUSICAL NOTES 

PA: 16 Sixteenth Note 
PA:32 Eighth Note 
PA:64 Quarter Note 
PA: 128 Half Note 
PA:256 Whole Note 


Figure 5-8 


The program shown 
Little Lamb.” 


in Figure 5-9 uses SO: and PA: to play the the song “Mary Had a 


10 R : MARY HAD A LITTLE LAMB 

20 R:ARRANGED IN 4 UOICES 

30 R:FOR COMPUTER 

40 C:«T=0 

50 «CODA 

60 C:OT=öT+l 

20 50:17..13.8 

80 PA:24 

90 50 : 15,. 13.8 

100 PA:8 

110 50:13 .8 

120 PA:32‘ 

130 50:15^13.8 
140 PA:32 
150 SO:17 .13 .8 
160 PA:32 
170 50:17.13.8 
180 PA:32 
190 50:17.13.8 
200 PAS64' 

210 50:15,. 12 .8 
220 PA:32 
230 50:15.12.8 
240 PA:32 
250 50:15.12 .8 
260 PA:64‘ 

270 50:17 .13 .8 

280 PA:32 

290 50 : 20..17 .13 .8 

30O PA:32 

310 50:20.17.13.8 

320 PA:64 

330 5P : 17 .13 8 

340 PA:24' 

350 50:15 .13 .8 
360 PA:8 
370 50:13 .8 
380 PA:32' 


390 

400 

410 

420 

430 

440 

450 

460 

470 

480 

490 

500 

510 

520 

530 

540 

550 

560 

570 

580 

590 


50 : 15..13 .8 
PA: 32 

50 : 17..13 .8 
PA : 32 

50 : 17..13..8 
PA : 32 

50 : 17..13 .8 
PA : 32 

50:15..12 .8 
PA:32 

50:15 / 12 .8 
PA : 32 

50:17,. 13 .8 
PA : 32 

50 : 15.. 12.. 8 
PA : 32 

50:13 .8 .5 .1 
PA:152 
50:0 

JC«T<2J:«CODA 
E: 


READY 


Figure 5-9 
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CONDITIONAL COMMANDS 




A condition is something about which a YES or NO decision can be made. For example, 
the weather could be a condition for deciding what to do today: Is it raining outside? If 
YES, go to the movies; if NO, go flying. 

In PILOT, there are two types of conditions: 

• String match conditions 

• Numeric conditions 
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_ YOR N_ 

String Match Conditions 


A MATCH command always sets up a YES or NO condition: YES (Y) there was a 
match, or NO (N), there was not a match. For example, in the program shown in Figure 
6-1, any answer containing the name “GRANT” produces a YES condition; any answer 
not containing “GRANT” produces a NO condition. 


10 R : GRANTS TOMB 

20 T i WHO WAS BUR IE D- IN GRANT'S 

TOMB? 

30 T i 

40 A:SANYONE 
50 M: GRANT 
60 T ! 

70 TYlYES, THAT IS CORBECT. 

$ANYONE WAS BURIED IN GRANT 1 S 

TOMB . 

80 TN : NO,. $ANYONE WAS NOT BURIED 
IN GRANT 1 S TOMB f GRANT WAS . 

90 T!SEE YOU AROUND. 

100 E: 

READY 


WHO MAS BURIED IN GRANT ‘ S TOMB? 

A GRANT FROM THE TULIP CORPORATION 

YES THAT IS CORRECT. A GRANT FROM 
THE TULIP CORPORATION WAS BURIED IN 
GRANT'S TOMB. 

SEE YOU AROUND. 


READY 



Figure 6-1 


You can make any PILOT command (T:, A:, M:, J:, C:, U:, E:, GR:, SO:, and PA:) 
conditional on a YES-match or NO-match by putting a Y or an N between the command 
and the colon (:). Here are some examples: 


TY: HELLO 

TN:WRONG 

EY: 

JN: * NEXT 
UY: * BOX 

SOY:13,17 


If there is a match, type “HELLO”; otherwise, skip this 
command. 

If no match, type “wrong”; otherwise, skip this command. 

If there is a match, end the program; otherwise, keep going. 

If no match, jump to Jfi NEXT; otherwise, skip this command. 

If there is a match, use the module sfc BOX; otherwise skip this 
command. 

If there is a match, sound notes 13 and 17; otherwise skip this 
command. 
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Figure 6-2 shows a program that uses String Match Conditions. 


10 R : DRAGON FEED 

20 T : CAN YOU NAME SOMETHING THAT 
30 T : DRAGONS LIKE TO EAT? 

40 A:$FOOD 

SO M: YESYUP., OK ^ FINE ^ 

SURE,, CAN f THINK I CAN . THINK SO 
60 T: 

70 TY : PLEASE NAME SOMETHING THEN . 
80 AY:$FOOD 

90 M: NO f NOT f CAN■T f DON 1 T . 
UNSURE 

100 TY : SORRY TO HEAR THAT . 

HO JY:»YONDER 

120 M:PEOPLE^ PRIN , KNI,. CAKE, 
PRETZ j, FLOMER 
130 T: 

140 TY : YES..DRAGONS SURE DO EAT 
5F00D. 

150 TN:VERYINTERESTING!IDIDN'T 
KNOM THAT DRAGONS ATE $FOOD . 

160 MYONDER 
170 T : 

180 TiTHAT'SALL FORNOH. SEE YOU 
AROUND. 

190 E : 

READY 


Figure 6-2 


You can see how this program works-in Figures 6-3 and 6-4. 



CAN YOU NAME SOMETHING THAT DRAGONS 
LIKE TO EAT? 

MHAT A SILLY QUESTION! OF COURSE I CAN 

PLEASE NAME SOMETHING THEN. 

BAGELS MITH CREAM CHEESE 

VERY INTERESTING! I DIDN ■ T KNOM THAT 
DRAGONS ATE BAGELS MITH CREAM CHEESE . 

THAT • S ALL FOR NOM. SEE YOU AROUND . 


READY 



Figure 6-3 
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HMSSj 


CAM YOU NAME SOMETHING THAT DRAGONS 
LIKE TO EAT? 

LITTLE PRINCESSES 

VES, DRAGONS SURE DO EAT LITTLE 
PRINCESSES. 

I " . . ~ ~ V i '■ ( * . A i £ * • „» "V ‘ I "> 

THAT> S ALL FOR NOM. SEE YOU AROUND. 

READY 


Figure 6-4 
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COMPARISON 

Numeric Conditions 


A YES/NO decision based on comparing two numbers is called a numeric condition. For 
example, if the amount of money in my pocket is equal to, or more than, the price of a 
hot fudge sundae, I will Order the sundae (YES condition); if it is less, I will Order 
something less expensive (NO condition). 


There are six possible comparisons you can make between two numbers. In PILOT, you 
express these comparisons using the following Symbols: 


#A = #B 

#A equals #B 

ffC < 20 

#C is less then 20 

#g > m 

#G is greater than #H 

#G <> 3 

#G is not equal to 3 

#L < = 5 

#L is less than or equal to 5 

#B > = #C 

#B is greater than or equal to #C 


You can make numeric comparisons between two numeric variables, or between a 
numeric variable and a constant, and you can make any PILOT command conditional on 
a numeric comparison. Enclose the comparison in parentheses and place it between the 
command and the colon (:), like the Y or N in a string match condition. Here are some 
examples: 

J (#G < 3): sfc AGAIN JUMP if the value is #G is less than 3 to % AGAIN; 

otherwise keep going. 

T (#A = #B): RIGHT! Type “Right!” if the value of #A equals the value of 

#B; otherwise, skip this command. 


A(#P< = 5): SANS Accept input from the keyboard if #P is less than or 

equal to 5; otherwise skip this command and keep 
going. 

SO(#N < >#R): 3,7 Sound the tones 3 and 7 if the value of #N is not 

equal to the value of #R; otherwise, skip this 
command. 


98 Conditionals- COMPARISON 





A common use of numeric conditions is setting up counting loops in programs. Figure 6-5 
shows a simple example of how a numeric condition is used to print something repeatedly 
for a desired number of times. 


10 R:GOOD BEHAUIOR 
20 TlHHAT IS YOUR FULL NAME? \ 

38 A:$NAME 

40 T : HOW MAHY TIMES? \ 

50 A:8T 

60 T:» CCLEARS THE SCREEN] 

70 C:öC=l 
80 »REPEÖT 
90 T(«C<10J : X 

100 T : «C . I HILL HOT TALK IN CLASS 
ANYMORE. 

HO c: «c=t»c + l 

120 JC8C<=»TJ:*REPEAT 
130 T : 

140 T:SINCERELY^ 

150 T:SNAME 
160 E : 

READY 




1. I WILL HOT TALK IN CLAS5 ANYMORE . 

2. I WILL NOT TALK IH CLASS ANYMORE. 

3. I HILL NOT TALK IN CLASS ANYMORE. 

4. I HILL NOT TALK IN CLASS ANYMORE. 

5. I HILL NOT TALK IN CLASS ANYMORE. 

6. I HILL NOT TALK IN CLASS ANYMORE. 

7. I HILL NOT TALK IN CLASS ANYMORE. 

8. I HILL NOT TALK IN CLASS ANYMORE. 

9. I HILL NOT TALK IN CLASS ANYMORE. 

10. I HILL NOT TALK IN CLASS ANYMORE. 

11. I HILL NOT TALK IN CLASS ANYMORE. 

12. I HILL NOT TALK IN CLASS ANYMORE. 

SINCERELY, I 

JOHN SMILEY 

( 

READY 


Figure 6-5 
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Figure 6-6 shows how you can use a numeric condition to limit a person to three guesses 
in a guessing game. 


10 RiWHAT AM I? 

29 T:HELCOME TO 1 'WHAT AM I? ■ ■ 

38 T : I ■ LL GIUE YOU 3 MINUS \ 

40 T:TO GUESS WHAT I AM . . . 

50 PA:60 
60 T: 

70 T : ARE YOU READY? \ 

80 A: 

90 T: 

100 M: Y,SURE,OK,FINE,ALRIGHT 
110 JN:»GQÖDBYE 
120 C:»G=1 
130 »LOOP 

140 TC«G = 1 J : I ROLL ALONG , BUT I DO 
NOT HAUE HHEELS . 

150 T t ÖG —2 ) : I HAUE A MOUTH . BUT I 
CANNOT SPEAK. 

160 T(ttG = 3) ilHAVEABED, BUT I 
NEUER SLEEP. 

170 T:WHAT AM I? 

180 T : 

190 A:$ANSWER 

200 M ! RIUER,STREAM,CREEK 

210 JY:»RIGHT 

220 JCOG=3J :»NOMORE 

230 TiNOPE,, GUE5S AGAIH. 

240 T : 

250 C:»G=HG+1 
260 J:»LOOP 
270 »NOMORE 
280 T : 

290 T.NOPE, THAT'STHREEGUESSES. 
300 T ! I AM A RIUER . 

310 J:»GOODBYE 
320 »RIGHT 
330 T: 

340 TiTHAT'SCORRECT! I AM 
$ANSWER . 

350 »GOODBYE 
360 T : 

370 PA:60 

380 T:SEE YOU LATER. 

390 E : 


i WELCOME I O ' * MHAT AM I? < 1 

f I ■ LL GIUE YOU 3 HINTS TO GUESS WHAT I 

| AM . . . 

ARE YOU READY? OK 

I ROLL ALONG,. BIIT I DO NOT HAUE 
WHEELS. 

WHAT AM I? 

TIN CAN 

! NOPE . GUESS AGAIN . 

I HAUE A MOUTH, BUT I CANNOT SPEAK . 

WHAT AM I? 

j RIUER 

THAT ■ S CORRECT ! I AM RIUER . 


Figure 6-6 


READY 
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JM: 

Jump on Match 


The JM: command causes the Computer to jump, conditional on matching one of a list of 
match alternatives. It is a variable jump rather than a constant jump, ln the simple 
J: LABEL command, you always jump to a single H* LABEL. This variable form of 

the JUMP command lets you jump to one of a variety of sfc LABELS, depending on 
what matches in an M: command. 


The JM: command must be paired with an M: command as follows: 
A: 

M: String 1, String2, String3, String4. 

JM: * LABEL1, * LABEL2, * LABEL3, * LABEL4. 


The JM: command should have the same number of labels as the M: has strings. The JM: 
command will jump to the sfc LABEL in the same position as the first string that matches 
the accepted input. In other words, if STRING1 is a match, JM: will jump to 
% LABEL1; if STRING2 is a match, JM: will jump to LABEL2, and so on. If there 
is no match, or if the position of a matched string does not correspond to the position of a 
% LABEL, then the JM: command will be skipped. 


Figure 6-7 is an example of the use of the JM: command. The program draws colored 
boxes on the screen in the size, color, and location of your choice. 


18 R:BOXES IN COLOR 

20 T : CH005E A SIZE., COLOR AND 

LOCATION. 

30 T i THIS PROGRAM DRAHS BOXES 
ACCORDING TO VOUR CHOICES. 

40 T : 

50 T : PRESS RETURN TO BEGIN 
60 A : 

70 GRiCLEAR 
80 »LOOP 
90 T: 

100 T:SIDE LENGTH? X 
110 AlttS 

120 TiHHAT COLOR CRED^BLUE,. 

YELLOW,. BLACK)? X 

138 a:$color 

140 M: RE j. BLU VE ^ BLA 

150 JM:»RED..»BLU / »YEL..»BLA 

160 »CONTINUE 

170 T: 

180 T : X LOCATION? X 
ISO A:nx 

200 T : Y LOCATION? X 
210 AiHY 
220 U:»BOX 
230 J:»LOOP 


240 »RED 

250 GR : PEN RED 

268 J:»CONTINUE 

270 »BLU 

280 GR: PEN BLUE 

290 J:»CONTINUE 

300 »YEL 

310 GR:PEN YELLOW 
320 J:»CONTINUE 
330 »BLA 
340 GR : PEN ERASE 
350 J:»CONTINUE 
360 »BOX 

370 GR : GOTO ttX^ttY 

380 GR : TURNTO 90;3CDRAH »S.ITURN 
90 J 

390 GR:FILL öS 
400 E : 

READY 
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_ APPENDIX A 

Special Function Keys 
and Screen Editing 

SPECIAL FUNCTION KEYS 


A number of keys on the ATARI 400/800™ Personal Computer System keyboards have 
a special function or purpose. These functions are described below. 




CAPS LOWR 


ESC 



CTRL 1} 


BREAK 


Reverse (Inverse) Video Key, or ATARI Logo Key: Pressing this 
key causes the text to be reversed on the screen (dark text on light 
background). Press the key a second time to return to normal text. 


Lowercase Key: Pressing this key shifts the screen characters from 
uppercase (capitals) to lowercase. To restore the characters to up- 
percase, press the Ifflffil key and the key 

simultaneously. 


Escape Key: Pressing this key causes a command to be entered 
into a program for later execution. 


Example: To clear the screen, you would enter: 
10 T:| 


ESC 

1 

CTRL 

I 

CLEAR 


This will cause a curved arrow to appear on your screen as 
follows: 

10 T: * 


Control Key: This key is used in conjunction with other keys to 
print special graphics control characters. See back cover or PILOT 
Reference Card for the specific keys and their screen-character 
representations. 


Control 1: Holding down üBItt and pressing 1 temporarily stops 
whatever is happening on the screen (e.g., a program listing). 
Pressing IfSpi 1 again restarts the screen action. 


Break Key: Pressing this key during program execution causes ex¬ 
ecution to stop. The line number and Statement where the execu¬ 
tion stopped are displayed on the screen followed by 


* *"READY 


* * * 
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SYSTEM RESET 


t 




DELETE BACK S 


CLEÄR 


RETURN 


System Reset Key: Similar to ilüiB in that pressing this key 
stops program execution. Also returns the screen display to the 
Text mode, clears the screen, and returns margins and other 
variables to their default values. 


Tab Key: Press Bllfff i f and the BBSl ||| keys simultaneously to 
set a tab. To clear a tab, press the and keys 

simultaneously. Used alone, the advances the Cursor 

to the next tab position. In Deferred mode, set and clear tabs by 
preceding the above with a line number, the command T:, a 
quotation mark, and pressing the §§§§ key. 


Examples: 100 T: 

200 T: 


rse § 

SHIFT ] 

! ii§f qp TAB 


I 

CTRL 

L 

SE T CLR TAB f 


Default tab settings are placed at columns 5, 14, 22, 30, and 38. 


Back Space Key: Pressing this key replaces the character to the 
left of the Cursor with a space and moves Cursor back one space. 


Clear Key: Pressing this key while holding down the BIS! or 
CTifl key blanks the screen and puts the Cursor in the upper left 
corner. 


Return Key: Terminator to indicate an end of a line of PILOT. 
Pressing this key causes a numbered line to be interpreted and ad- 
ded to a PILOT program in RAM. 


An unnumbered line (in Immediate mode) is interpreted and ex- 
ecuted immediately. Any variables are placed in a variable table. 



SCREEN EDITING 

The keyboard and display are logically combined for a mode of Operation known as 
screen editing. Each time a change is completed on the screen, the SSffffll key must be 
pressed. Otherwise, the change is not made to the program in memory. 

Example: 10 T:REMEMBER TO PRESS RETURN 
15 T: AFTER LINE EDIT 
20 T:THIS LINE IS GOING AWAY 
30 T:THIS WILL BE THE FIRST 
40 T:LINE ON THE SCREEN. 

50 E: 
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To delete line 20 from the program, type the line number and press the ijSSÜILL« key. 
Merely deleting the line from the screen display does not delete it from the program. 


RETURN 


In addition to the special function keys described above, there are Cursor control, insert, 
and delete keys that allow immediate editing capabilities. These keys are used in conjunc- 
tion with the StSlÜfS or iM keys as follows: 


1 


SS 


CTRL 


CTRL 


CTRL 


Moves Cursor up one physical line without changing the program 
or display. 

Moves Cursor one space to the right without disturbing the program 
or display. 

Moves Cursor down one physical line without changing the pro¬ 
gram or display. 

Moves Cursor one space to the left without disturbing the program 
or display. 


Like the other keys on the ATARI keyboard, holding the Cursor control keys for more 
than V 2 second causes the keys to repeat. 


INSERT 


SHIFT | INSERT 

CTRLflNSERT] 

DELETE BACK S 


SHIFT | DELETE j 
;TRL I DELL Ifc 1 


SYSTEM RESET 


Insert key: Press the and _ __ 

to insert a line. To insert a single character, press the 
keys simultaneously. 


keys simultaneously 
m and 


INSERT 


Inserts one physical line. 
Inserts one character space. 
Delete key: Press the 


and 


DELETE BACK S 


delete a line. To delete a single character, press 
simultaneously. 


keys simultaneously to 


DELETE BACK S 


Deletes one physical line. 
Deletes one character or space. 


Note: You should not use screen editing features other than Backspace/Delete in AUTO 
mode. Instead, return to the Immediate mode and LIST your program to use screen 
editing. 
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APPENDIX B 

PILOT I/O Error Codes 


t 


This appendix lists the ATARI 400/800 Computer Systems’ I/O error codes within the 
context in which they will be seen in ATARI PILOT. Not allof the System codes are 
presented here, because some of them cannot occur within the PILOT environment. 


130 

A nonexistent device was specified. 


131 

A READ command followed a WRITE command with the same 
specified. 

device 

135 

A WRITE command followed a READ command with the same 
specified. 

device 

136 

End-of-file condition. 


138 

Device timeout; device doesn’t respond. (See Note) 


139 

Device NAK. (See Note) 


140 

Serial bus framing error. (See Note) 


141 

Screen Cursor out of ränge (READ from or WRITE to ‘S’). 


142 

Serial bus data from overrun. (See Note) 


143 

Serial bus data from checksum error. (See Note) 


144 

Device DONE error. (See Note) 


145 

Disk read after write compare error. (See Note) 


146 

Function not implemented for device (e.g., OUT:K). 


147 

Insufficient RAM for operating the graphics screen. 


160 

Disk drive number error. 


161 

Too many concurrent disk files being accessed. 


162 

Disk is full (no free sectors). 


163 

Fatal System data I/O error. 


164 

File number mismatch. (See Note) 



1 
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165 Disk file naming error. 

167 Disk file locked. 

169 Disk directory full (64 files). 

170 Disk file not found in directory. 

Note : These errors indicate problems over which the user has no direct control; they 
are due to hardware problems and should seldom be seen. 
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C017811 REV.A 












Frogrammeci 

nquiry 

Learning 

Or 

eaching 

with "Turtle" Graphics 


Pocket Reference Card 



ATARI 



A Warner Communications Company 






VARIABLE TYPES 


r 




Numeric variables 
#A to #Z 

String variables 
$ followed by 
alphanumeric name 
(example: $FOOD) 

Machine variables 
% followed by one or 
two characters 
(example: %Y) 


Integer variables can contain a number from -32768 to 32767. 


String variables can contain literal strings of up to 255 characters. 


Machine variables contain the Status of light pen, joystick, Cursor location, and other machine 
Parameters. 


V 


Pointer variables 
@ followed by a 
number or by B and a 
number (example: 

@ B77) 


Pointer variables refer to the contents of bytes (B) or words whose decimal address in memory is 
given by the numeric portion of the variable name 


y 


r 


ARITHMETIC OPERATORS 


RELATIONAL OPERATORS 




+ Addition 
— Subtraction 
* Multiplication 
/ Division 

\ Modulo Operation (remainder after division) 

? Random number generation (generates random number between 
-32768 and 32767). 


= Equal 
> Creater than 
< Less than 
>= Creater or equal 

< = Less or equal 

< > Not equal 


J 


Atari, Inc., Computer Division 
P.O. Box 427 
Sunnyvale, CA 94086 

Program Contents ©1980 ATARI, Inc. 
Manual Contents ©1981 ATARI, Inc. 
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Command 

T: 

Function 

Type to screen 

COMMANDS 

Example 

T THIS IS SOME TEXT 

Result 

Prints THIS IS SOME TEXT on the screen. 



T:#A or T:$NAME 

Prints contents of numeric variable (#A) or string 
variable ($NAME) on the screen. 

A: 

Accept from keyboard 

A: 

Places keystrokes in the accept buffer. 



A:#B or A:$FOOD 

Places keystrokes in the accept buffer and in the 
variable #B or $FOOD. 

M: 

Match command 

M: YES, YUP, SURE 

Checks each entry in the list against contents of 
accept buffer and sets Y and N flags. (See 
CONDITIONALS.) 

R: 

Remark 

R: LOOP BECINS HERE 

Remark for user only —no effect on program. 

J: 

Jump command 

J: ‘JUMPHERE 

Jumps execution to the label ‘JUMPHERE. 

E: 

Ends program 

E: 

Terminates program execution. 

C: 

Compute command 

C: #A = #A + #B 

Performs computation shown to right of colon 
(add #B to #A and put the result in #A). 

U: 

Use module 

U: ‘NEXTSET 

Uses the module ‘NEXTSET and returns at the 
end of that module. 

SO: 

Sound command 

SO: #A,#B,#C,#D 

Generates up to four musical tones (tones in- 
crease by VS Step per number). 



SO: 13 

Generates Middle C. 

PA: 

Pause command 

PA: 5 

Stops PILOT execution for 5/60 second. 

JM: 

Jump on match 

JM: ‘HERE, ‘START, *END 

Jumps to label corresponding to match field. 

MS: 

Match to make strings 

MS: IS, ARE, WILL 

Splits contents of buffer into $LEFT, $MATCH, 
and SRICHT. 

POS: 

Position text Cursor 

POS: 12,15 

Positions Cursor at 12th column and 15th row. 

VNEW: 

Clears variables 

VNEW: 

Clears all variables. 



VNEW: # or VNEW: $ 

Clears all numeric or all string variables. 

CALL: 

Calls machine language 
program 

CALL: 40% 

PILOT jumps to execute machine language pro¬ 
gram at decimal location 40%. 


COMDITIONALS 

The execution of any PI LOT command can be made conditional on the presence or absence of a string match or on the truth of a 
numeric relationship. 

String Match Conditions 

The conditional variables Y (YES) and N (NO) are set by the result of a match (M:) command. 

Numeric Conditions 

Relational operators are used to compare two numbers or variables. If the relation is true, the accompanying PILOT command 
will be executed. 


Examples: 

TY: COOD CUESS (prints GOOD CUESS if result of preceding match command was true). 
JN: ‘RESTART (jumps to ‘RESTART if result of preceding match command was false). 

E (#A< 7): (ends program execution if #A is less than 7). 


r 


K. 

r 













GRAPHICS COMMANDS 

Command 

Function 

Example 

Result 

CLEAR 

Clear screen 

CR: CLEAR 

Clears text and graphics window. 

QUIT 

Return to text mode 

GR: QUIT 

Clears graphics window and returns to text-only 
mode. 

PEN 

Sets pen color to red, 
yellow, blue, or erase 

CR: PEN RED 

Sets pen color to red. 


(background color) or lifts 
pen 

CR: PEN UP 

Lifts pen. 

GOTO 

Cursor move (absolute) 

CR: GOTO 0,0 

Moves Cursor to 0,0 (center of screen). 

DRAWTO 

Draw line (absolute) 

CR: DRAWTO 10,15 

Draws line from previous Cursor Position to coor- 
dinate 10,15. 

TURNTO 

Turn Cursor heading (ab¬ 
solute) 

CR: TURNTO 0 

Turns Cursor to 0 degrees (straight up). 

FILLTO 

Fill (absolute) 

CR: FILLTO -6,5 

Draws line from previous Cursor Position to -6,5 
and fills to the right with color. 

GO 

Cursor move (relative) 

CR: CO 25 

Moves Cursor 25 units in present heading. 

DRAW 

Draws line (relative) 

CR: DRAW 17 

Draws 17 units in present heading. 

TURN 

Turns Cursor (relative) 

CR: TURN 48 

Turns Cursor heading by 48 degrees to the right. 

FILL 

Fill (relative) 

CR: FILL 30 

Draws line 30 units along present heading and 
fills to the right with color. 


v___/ 


EXECUTIVE AND INPUT/OUTPUT COMMANDS 


LIST 

RUN 

SAVE 

DOS 

NEW 

LOAD 

AUTO 

REN 

TAPE: ON 
TAPE: OFF 
TSYNC: 
READ 

WRITE 

CLOSE 


Lists program Statements on screen. 

Starts executing program at first Statement. 

Saves program to cassette (SAVE C:) or to disk (SAVE D:filename). To list a program on a printer, type SAVE P:. 
Enters the Disk Operating System command menu. 

Erases all PILOT program Statements in memory. 

Loads a program from cassette (LOAD C:) or disk (LOAD D:filename) without erasing resident program list. 
Enters auto numbering made for writing programs. 

Renumbers program lines. 

Turns cassette motor on. 

Turns cassette motor off. 

Allows PILOT to synchronize specially prepared tapes. 

Reads data from attached device to the accept buff er (Example: READ: C, $DATA reads from cassette to buff er and 
variable $DATA). 

Writes data to an attached device (Example: WRITE: RI, HELLO THERE writes HELLO THERE to RS-232 port RI). 
Closes device previously opened with READ or WRITE (Example: CLOSE:C). 
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